Solveig
Turns any LLM into an agentic AI assistant in 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.5:free"
Features
🤖 Agentic CLI 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, collapsible usage stats, diff editing, code linting, waiting animations and directory tree displays for informed user decisions. Supports multiple themes.
📋 MCP Support - easily add and filter multiple tools from MCP servers.
🌐 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
1 maintainer
Release files for solveig 0.7.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| solveig-0.7.2.tar.gz | 128.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| solveig-0.7.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 274.2 kB
Release files / solveig-0.7.2.tar.gz
| Download URL | solveig-0.7.2.tar.gz |
|---|---|
| Size | 128.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
d56918e106e249dd4a9de8e9b139bff85dfe35e331ce6eecc9bcb6ac30bc6b0f
|
|
BLAKE2b-256 checksum How to use checksums |
fa8dc9ad0726cb7da5be8272ab1b9526fac5d0152594814e791c6a6e45aad5f1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Apr 17, 2026.
Transparency logRelease files / solveig-0.7.2-py3-none-any.whl
| Download URL | solveig-0.7.2-py3-none-any.whl |
|---|---|
| Size | 145.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c4d127b107163fa984b0c60fd530322f6d0d41e408417da44ffc70629c42a715
|
|
BLAKE2b-256 checksum How to use checksums |
06113484511f0c7f7996fdaafc9b14b89e0653fdbc167e4a737ce5cf2fbb2024
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Apr 17, 2026.
Transparency log
