An AI assistant that enables secure and extensible agentic behavior from any LLM in your terminal
Project description
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
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 OpenAI, Claude, Gemini, local models, or any OpenAI-compatible API.
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
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file solveig-0.5.10.tar.gz.
File metadata
- Download URL: solveig-0.5.10.tar.gz
- Upload date:
- Size: 87.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ffa0daf6f3b49e65304f3c462b0f2862718f8d06f414b664c882c58559ed200d
|
|
| MD5 |
0df99dfadb6927ae580828529eb88633
|
|
| BLAKE2b-256 |
de67c1876b26ba09579df0959e96e95fa68f9a6e6918b7883a156576f67333fb
|
Provenance
The following attestation bundles were made for solveig-0.5.10.tar.gz:
Publisher:
cd.yml on FSilveiraa/solveig
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
solveig-0.5.10.tar.gz -
Subject digest:
ffa0daf6f3b49e65304f3c462b0f2862718f8d06f414b664c882c58559ed200d - Sigstore transparency entry: 677462147
- Sigstore integration time:
-
Permalink:
FSilveiraa/solveig@a076bbb0d2b201e3d47ec6c2c37bef485b1bc34e -
Branch / Tag:
refs/heads/main - Owner: https://github.com/FSilveiraa
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
cd.yml@a076bbb0d2b201e3d47ec6c2c37bef485b1bc34e -
Trigger Event:
push
-
Statement type:
File details
Details for the file solveig-0.5.10-py3-none-any.whl.
File metadata
- Download URL: solveig-0.5.10-py3-none-any.whl
- Upload date:
- Size: 90.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e9ab9b6c6c30684fe392613df25a41bc0f57c028557472428f2e3bc3d9fda314
|
|
| MD5 |
865d3fa1a861d8e89810d828a53d48c8
|
|
| BLAKE2b-256 |
78ebd3fad113379cb1f27e9a3d8574a2e5955ef9d1c32ec026296307a44275fb
|
Provenance
The following attestation bundles were made for solveig-0.5.10-py3-none-any.whl:
Publisher:
cd.yml on FSilveiraa/solveig
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
solveig-0.5.10-py3-none-any.whl -
Subject digest:
e9ab9b6c6c30684fe392613df25a41bc0f57c028557472428f2e3bc3d9fda314 - Sigstore transparency entry: 677462170
- Sigstore integration time:
-
Permalink:
FSilveiraa/solveig@a076bbb0d2b201e3d47ec6c2c37bef485b1bc34e -
Branch / Tag:
refs/heads/main - Owner: https://github.com/FSilveiraa
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
cd.yml@a076bbb0d2b201e3d47ec6c2c37bef485b1bc34e -
Trigger Event:
push
-
Statement type: