Solveig
An AI assistant that brings safe agentic behavior from any LLM to your terminal
About | Usage | Comparison | Themes | Plugins | Roadmap | Contributing
Quick Start
Installation
# Core installation (OpenAI + local models) pip install solveig # With support for Claude and Gemini APIs pip install solveig[all]
Running
# Run with a local model solveig -u "http://localhost:5001/v1" "Create a demo BlackSheep webapp" # Run from a remote API like OpenRouter solveig -u "https://openrouter.ai/api/v1" -k "<API_KEY>" -m "moonshotai/kimi-k2:free"
Features
🤖 AI Terminal Assistant - Automate file management, code analysis, project setup, and system tasks using natural language in your terminal.
🛡️ Safe by Design - Granular consent controls with pattern-based permissions and file operations prioritized over shell commands.
🔌 Plugin Architecture - Extend capabilities through drop-in Python plugins. Add SQL queries, web scraping, or custom workflows with 100 lines of Python.
📋 Modern CLI - Clear interface with task planning, file and metadata previews, diff editing, usage stats, code linting, waiting animations and directory tree displays for informed user decisions.
🌐 Provider Independence - Works with any OpenAI-compatible API, including local models.
Documentation
- About - Detailed features and FAQ
- Usage - Config files, CLI flags, sub-commands, usage examples and more advanced features
- Comparison - Detailed comparison to alternatives in the same market space
- Themes - Themes explained, visual examples
- Plugins - How to use, configure and develop plugins
- Roadmap - Upcoming features and general progress tracking
- Contributing - Development setup, testing, and contribution guidelines
