solveig 0.4.5

A safe bridge between AI assistants and your computer

Solveig

A CLI bridge that enables safe, extensible agentic behavior from any model on your computer

Installation

pip install solveig

Quick Start

# 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" "Refactor test_database.py to be more concise"

---

Key Features

📂 Files and Commands - Rich File API that prioritizes safe filesystem access, while also offering full shell capability.
🛡️ Granular Permissions - Safe defaults with explicit user consent. Supports granular configuration using patterns.
🔌 Plugins - Extensible requirement system for custom AI capabilities through simple drop-in plugins. Add an AI SQL query runner with 100 lines of Python.
📋 Clear Interface - Clear progress tracking and content display that inform user consent and choices.
🌐 Provider Agnostic - Works with any OpenAI-compatible API including local models, Claude and Gemini.

---

Documentation

• Usage Guide - Configuration options, examples, and advanced features
• Plugin Development - How to create and configure custom plugins
• About & Comparisons - Detailed features and how Solveig compares to alternatives
• Contributing - Development setup, testing, and contribution guidelines

---