solveig 0.5.8

An AI assistant that enables secure and extensible agentic behavior from any LLM in your terminal

Solveig

An AI assistant that enables secure and extensible agentic behavior from any LLM in your terminal

You can also see the Demo in video format here

Features  |  FAQ  |  Usage  |  Plugins  |  Themes  |  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 plan tracking, task listing, file and metadata previews, diff view, code linting, waiting animations and rich tree displays for informed user decisions.

🌐 Provider Independence - Works with OpenAI, Claude, Gemini, local models, or any OpenAI-compatible API.

---

Documentation

• About & Comparisons - Detailed features, FAQ and how Solveig compares to alternatives
• Usage Guide - Config files, CLI flags, sub-commands, usage examples and more advanced features
• Themes - Themes explained, visual examples
• Plugin Development - How to create and configure custom plugins
• Roadmap - Upcoming features
• Contributing - Development setup, testing, and contribution guidelines

---