Skip to content

README.md

Latest commit

 

History

History
210 lines (152 loc) · 6.94 KB

README.md

File metadata and controls

210 lines (152 loc) · 6.94 KB

⚡ GraTech Commander

Your AI, Your Rules, Your Language 🇸🇦

Version License Platform Made in

GraTech Commander Banner

The first Arabic-native AI command center that respects your privacy

🚀 Quick Start • ✨ Features • 🛡️ Safety • 📖 Docs

🎯 What is GraTech Commander?

GraTech Commander is a privacy-first, multi-model AI interface built for Arabic speakers (and 11 other languages). Unlike cloud-based AI tools, your data stays on YOUR device.

╔══════════════════════════════════════════════════════════════════╗
║  🧠 5 AI Models    │  🔐 100% Local    │  🗣️ Arabic Native      ║
║  🛡️ Smart Safety   │  ⚡ Fast Setup    │  🎨 Beautiful UI       ║
╚══════════════════════════════════════════════════════════════════╝

✨ Features

🤖 Multi-Model AI Support

Model Best For Status
GPT-4.1 Balanced & Fast ✅ Available
Claude Opus 4.5 Deep Analysis ✅ Available
DeepSeek R1 Code & Logic 🔥 ✅ Available
GPT-4o Speed ✅ Available
DeepSeek V3.2 Reasoning ✅ Available

🗣️ Arabic Understanding

Write in Saudi dialect, get professional results:

You Write AI Understands
"سو لي موقع" Create a website
"فكك من الكلام وعطني كود" Skip explanations, give me code
"وش الفرق بين X و Y" Explain the difference between X and Y

🌍 12 Languages Supported

🇸🇦 العربية • 🇺🇸 English • 🇫🇷 Français • 🇩🇪 Deutsch • 🇪🇸 Español • 🇨🇳 中文 • 🇯🇵 日本語 • 🇰🇷 한국어 • 🇹🇷 Türkçe • 🇷🇺 Русский • 🇮🇳 हिन्दी • 🇵🇰 اردو

🛡️ Safety System

Your consent, always.

┌─────────────────────────────────────────────────────────────┐
│  🟢 Safe      │ Read, View           │ No confirmation     │
│  🟡 Low       │ Create new           │ Simple confirm      │
│  🟠 Medium    │ Modify, Execute      │ Confirm + Explain   │
│  🔴 High      │ Delete, Deploy       │ Double confirm      │
│  ⛔ Critical  │ Destroy, Production  │ Confirm + Screenshot│
└─────────────────────────────────────────────────────────────┘

Philosophy:

"I'm here to serve you, not control you. The decision is always yours."

🚀 Quick Start

Option 1: Web Version (Fastest)

# Clone
git clone https://github.com/GrAxOS/GraTechCommander.git
cd GraTechCommander

# Open in browser
start index.html  # Windows
open index.html   # macOS

Option 2: Desktop App (Electron)

# Install dependencies
npm install

# Run
npm start

# Build EXE
npm run build:win

Option 3: WPF Desktop (Windows Native)

# Open in Visual Studio
GraTechCommander.sln

# Build & Run
Ctrl + F5

📁 Project Structure

GraTechCommander/
├── 🌐 Web Version
│   ├── index.html        # Main UI
│   ├── styles.css        # Styling (1500+ lines)
│   ├── renderer.js       # Core logic
│   ├── translator.js     # Arabic → English prompt
│   ├── safety.js         # Protection system
│   └── onboarding.js     # First-run wizard
│
├── 🖥️ WPF Version (C#)
│   ├── MainWindow.xaml   # UI Layout
│   ├── ViewModels/       # MVVM Pattern
│   ├── Services/         # Azure AI, GitHub
│   └── Core/             # Ethics Engine
│
└── 📄 Config
    ├── package.json      # Node dependencies
    └── .gitignore        # Git exclusions

⚙️ Configuration

BYOK (Bring Your Own Key)

  1. Get your API key from Azure AI Foundry or OpenAI
  2. Open Settings ⚙️
  3. Enter your credentials:
🔑 API Key: sk-xxxxxxxx OR Azure Key
🌐 Endpoint: https://your-resource.openai.azure.com/

Privacy Promise: Your keys stay on YOUR device. We never send them anywhere.

🔧 API Endpoints

Service Endpoint Auth
Azure OpenAI https://{resource}.openai.azure.com/ API Key
Azure AI Foundry https://{resource}.services.ai.azure.com/ API Key
GitHub https://api.github.com/ Personal Token

📊 Tech Stack

Layer Technology
Web UI HTML5, CSS3, Vanilla JS
Desktop Electron / WPF (C#)
AI Backend Azure AI Foundry, OpenAI
Design RTL-first, Dark Mode
State LocalStorage (encrypted)

🤝 Contributing

We welcome contributions! Here's how:

# Fork the repo
# Create your branch
git checkout -b feature/amazing-feature

# Commit changes
git commit -m "Add amazing feature"

# Push
git push origin feature/amazing-feature

# Open a Pull Request

📜 License

MIT License - Use freely, give credit.

👨‍💻 Creator

Suliman Nazal Alshammari

GitHub Organization Website Email

🌟 Star this repo if it helped you!

Stars

"The word Algorithm was born in my land, from my ancestor Al-Khwarizmi." 🏜️

صنع بـ ❤️ في السعودية 🇸🇦