Skip to main content

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

Demo GIF

PyPI CI codecov Python 3.13+ License: GPL v3 Code style: black

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


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.5.6.tar.gz (88.2 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.5.6-py3-none-any.whl (91.0 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for solveig-0.5.6.tar.gz
Algorithm Hash digest
SHA256 db17ee060473cd467864b751f09e98742811e9fab09c4627add8bbad8ce7ab6e
MD5 99e24feecf6cb085780b2fa1d4d6d720
BLAKE2b-256 f90deaa2ab1f25552427b948da5bc18529995e1b3a819c0998e1e1492075e3c6

See more details on using hashes here.

Provenance

The following attestation bundles were made for solveig-0.5.6.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.5.6-py3-none-any.whl.

File metadata

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

File hashes

Hashes for solveig-0.5.6-py3-none-any.whl
Algorithm Hash digest
SHA256 edab50111ab904cc0d7b11f1cadcc369f0c1394223ae9453a217544e700cbe58
MD5 17024b253a871dd75b6420104217f888
BLAKE2b-256 641fabe373fcf9fae8040be9b824fabd8f3e2cf868cb72aeb3c012d1f48874a5

See more details on using hashes here.

Provenance

The following attestation bundles were made for solveig-0.5.6-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