Your Intelligent, Privacy-Focused, Universal OS Companion
Chat, execute local system commands seamlessly across OS environments, and perform RAG-based file searches directly from a stunning glassmorphic interface—100% locally.
VOIDER replaces clunky terminal operations with a sleek, unified graphical interface running natively on your system.
- 🔒 100% Privacy Focused: Powered locally by Ollama and FAISS. No cloud APIs, utter privacy.
- 🖥️ Cross-Platform Compatibility: Generates and executes commands tailored to your specific Linux, Windows, or macOS environment.
- 🛡️ Safe Command Execution: Multi-layered blocklist prevents destructive commands (e.g.,
rm -rf /). - 🧠 RAG-Powered File Search: Ask questions about your local documents and get highly accurate, contextualized answers.
- 🎨 Stunning Glassmorphic UI: macOS-inspired translucent "unibody" window with dynamic futuristic aesthetics.
- 🔌 Multi-Provider Support: Seamlessly switch between local models (Ollama) and cloud APIs (Groq, OpenAI, Gemini, xAI).
Get VOIDER up and running in seconds.
- Python 3.10+
- Ollama (running locally)
curl -sSL https://raw.githubusercontent.com/yourusername/voider/main/install.sh | bash
./start.sh(If you have cloned the repo, simply run ./install.sh followed by ./start.sh)
Tip
Do you have a low-spec system and prefer to use a Cloud API (like Groq, OpenAI) instead of running local LLMs? You can bypass the native Ollama requirement entirely by starting the application with:
./start.sh --no-ollamaDownload the latest voider-setup.exe from the Releases page and run the installer.
Alternatively, via PowerShell:
Invoke-WebRequest -Uri "https://github.com/yourusername/voider/releases/latest/download/voider-setup.exe" -OutFile "voider-setup.exe"
start voider-setup.exesudo rpm -i voider-ai-os-1.0-1.fc43.x86_64.rpm
./start.shRuns the full VOIDER stack in containers. No Python setup required!
Prerequisites: Docker + Docker Compose
git clone https://github.com/Ashishdevpandey/VOIDER---OS-COMPANION.git
cd VOIDER---OS-COMPANION
# Interactive Setup (Recommended)
# Asks you to choose between Local (Ollama) or Cloud (API)
./docker-install.sh
# Cloud provider (Direct setup)
./docker-install.sh --provider groq --api-key gsk_YOUR_KEY --no-ollama
# OpenAI / Gemini / xAI
./docker-install.sh --provider openai --api-key sk-YOUR_KEY --no-ollamaTip
Use the Cloud setup if you have limited RAM (requires < 512MB). Use Local for maximum privacy (requires 8GB+ RAM).
Then open http://localhost:8000/ui 🎉
# 1. Copy and configure
cp .env.example .env
# Edit .env: set VOIDER_PROVIDER and VOIDER_API_KEY
# 2. Build & start
docker compose up -d --build
# 3. View logs
docker logs -f voiderdocker compose down # Stop all containers
docker compose restart voider # Restart just VOIDER
docker logs -f voider # Follow logs
docker exec -it voider bash # Shell into containerVOIDER operates via a decoupled architecture, joining a high-performance Python application on the backend with a lightweight, highly-polished frontend.
| Feature | VOIDER 🌌 | Open Interpreter | Copilot CLI | Native Terminal |
|---|---|---|---|---|
| UI | Stunning Glassmorphic Web App | Terminal | Terminal | Terminal |
| Privacy | 100% Local (Ollama) | API Key needed (default) | Cloud | N/A |
| Safety Blocklist | Yes, Built-in | Prompts User | Prompts User | None |
| RAG File Search | Auto-indexed Local Docs | Basic Python Read | No | Grep/Find |
| Cost | Free (Open Source) | Varies (API) | Subscription | Free |
VOIDER is built for the open-source community, and we want YOU!
Looking to get involved? Check out our issues labeled good first issue—perfect for newcomers:
- 🐛 Bug: Fix UI overflow on ultra-wide monitors.
- 📝 Docs: Add Docker setup instructions.
- ✨ Feature: Add a new theme to the UI settings.
- Fork the repo and throw us a Star ⭐!
- Create your feature branch:
git checkout -b feature/amazing-feature - Commit your changes:
git commit -m 'Add amazing feature' - Push to the branch:
git push origin feature/amazing-feature - Open a Pull Request!
Reach out to me at ashisdvpandey@gmail.com
Made with ❤️ by the VOIDER Open Source Community