Skip to main content

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

Project description

PyPI   CI   codecov   Python 3.13+   Ruff   License: GPL v3  


Solveig

Turns any LLM into an agentic AI assistant in your terminal

Demo


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

Support Ukraine: https://stand-with-ukraine.pp.ua/

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

solveig-0.7.2.tar.gz (128.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

solveig-0.7.2-py3-none-any.whl (145.5 kB view details)

Uploaded Python 3

File details

Details for the file solveig-0.7.2.tar.gz.

File metadata

  • Download URL: solveig-0.7.2.tar.gz
  • Upload date:
  • Size: 128.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for solveig-0.7.2.tar.gz
Algorithm Hash digest
SHA256 d56918e106e249dd4a9de8e9b139bff85dfe35e331ce6eecc9bcb6ac30bc6b0f
MD5 e4e37f774175c2f7520f18b2b6b154f7
BLAKE2b-256 fa8dc9ad0726cb7da5be8272ab1b9526fac5d0152594814e791c6a6e45aad5f1

See more details on using hashes here.

Provenance

The following attestation bundles were made for solveig-0.7.2.tar.gz:

Publisher: cd.yml on FSilveiraa/solveig

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file solveig-0.7.2-py3-none-any.whl.

File metadata

  • Download URL: solveig-0.7.2-py3-none-any.whl
  • Upload date:
  • Size: 145.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for solveig-0.7.2-py3-none-any.whl
Algorithm Hash digest
SHA256 c4d127b107163fa984b0c60fd530322f6d0d41e408417da44ffc70629c42a715
MD5 6dfcdf270a95bc7264b5298f2910b89d
BLAKE2b-256 06113484511f0c7f7996fdaafc9b14b89e0653fdbc167e4a737ce5cf2fbb2024

See more details on using hashes here.

Provenance

The following attestation bundles were made for solveig-0.7.2-py3-none-any.whl:

Publisher: cd.yml on FSilveiraa/solveig

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page