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

You can also see the Demo in video format here

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


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.5.7.tar.gz (88.5 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.7-py3-none-any.whl (91.1 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: solveig-0.5.7.tar.gz
  • Upload date:
  • Size: 88.5 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.7.tar.gz
Algorithm Hash digest
SHA256 eaec5087b60e7222150afdaa105cc37b383e99077a2ffc6a2d4143c6be1f5598
MD5 df5c261556a64c5343184f63b03f7fb0
BLAKE2b-256 de0f4f31b9446c581ffaea8f08896266bfbcfecea4b553bb86d5ce891a13d7e8

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: solveig-0.5.7-py3-none-any.whl
  • Upload date:
  • Size: 91.1 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.7-py3-none-any.whl
Algorithm Hash digest
SHA256 7ee8e0f3b4d70ace19c012851c81c0baf487f5e4e6fa6dc2ec0487898e6dd2a6
MD5 0d0f7714007bd2787230502533f2f939
BLAKE2b-256 38cc4ee45c35738bea06cda612adbedfddf8a73d5616fd078430a14c2e297fe3

See more details on using hashes here.

Provenance

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