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.

📋 Visual Task Management - Clear plan tracking with task breakdowns, file previews, code linting, 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.3.tar.gz (86.6 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.3-py3-none-any.whl (89.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: solveig-0.5.3.tar.gz
  • Upload date:
  • Size: 86.6 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.3.tar.gz
Algorithm Hash digest
SHA256 385a3392cd9f99d196e559efd250e47dcac6d18c25a1f79b8378ec67d0546b5e
MD5 6e271894799d8fae4ce837d3742072b9
BLAKE2b-256 6fc1cb1ec2c2c1e0935bcb5e95544078fb503d3590896b9615398184e0839041

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: solveig-0.5.3-py3-none-any.whl
  • Upload date:
  • Size: 89.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.3-py3-none-any.whl
Algorithm Hash digest
SHA256 87010a56d8c3b1a243051181c40d3a8644109bba3fbf7aec635ebc3f849022ce
MD5 bf7be0988e3f8ac552ea3e4bd8a7bc49
BLAKE2b-256 3e6d1d082337269a1853f9db3e7dcf6cf497e6a72ba5a2dd9c80ecaf9ceab28a

See more details on using hashes here.

Provenance

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