Metadata-Version: 2.4
Name: llmrix-hestia
Version: 0.1.1
Summary: LLMRIX AI Agent SDK
Author: llmrix
License-Expression: GPL-3.0-only
Project-URL: Homepage, https://github.com/llmrix/llmrix-hestia
Project-URL: Repository, https://github.com/llmrix/llmrix-hestia
Project-URL: Changelog, https://github.com/llmrix/llmrix-hestia/releases
Keywords: ai,agent,llm,langchain,langgraph,mcp,acp,cli,deepagents
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Operating System :: OS Independent
Classifier: Typing :: Typed
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: deepagents>=0.6.9
Requires-Dist: langgraph>=1.2.2
Requires-Dist: langgraph-checkpoint>=4.1.0
Requires-Dist: langgraph-prebuilt>=1.1.0
Requires-Dist: langchain>=1.3.2
Requires-Dist: langchain-core>=1.4.0
Requires-Dist: langchain-openai>=1.2.2
Requires-Dist: langchain-anthropic>=1.4.3
Requires-Dist: langchain-mcp-adapters>=0.2.2
Requires-Dist: langchain-litellm>=0.2.0
Requires-Dist: langchain-quickjs>=0.2.0
Requires-Dist: litellm>=1.86.2
Requires-Dist: rich>=13.0.0
Requires-Dist: pydantic>=2.7.0
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: agent-client-protocol>=0.10.0
Requires-Dist: deepagents-acp>=0.0.6
Requires-Dist: asyncpg>=0.29
Requires-Dist: psycopg2-binary>=2.9
Requires-Dist: pgvector>=0.3.0
Requires-Dist: langgraph-checkpoint-postgres>=3.1.0
Requires-Dist: redis>=5.0
Requires-Dist: apscheduler[sqlalchemy]>=3.10
Requires-Dist: langchain-daytona>=0.0.6
Requires-Dist: docker>=7.1.0
Requires-Dist: oss2>=2.18.0
Requires-Dist: bcrypt>=4.0
Requires-Dist: httpx>=0.27
Requires-Dist: fastapi>=0.115.0
Requires-Dist: uvicorn>=0.30.0
Requires-Dist: sqlalchemy>=2.0.0
Requires-Dist: aiosqlite>=0.19.0
Requires-Dist: pyyaml>=6.0.0
Requires-Dist: pillow>=10.0.0
Requires-Dist: lxml>=5.0.0
Requires-Dist: openpyxl>=3.1.0
Requires-Dist: pypdf>=4.0.0
Requires-Dist: pdfplumber>=0.10.0
Requires-Dist: pdf2image>=1.16.0
Requires-Dist: defusedxml>=0.7.1
Dynamic: license-file

# llmrix-hestia

AI Agent SDK — build, deploy, and extend intelligent agents with a single `pip install`.

## Features

- **Multi-provider LLM support** — Anthropic, OpenAI, OpenRouter, Ollama, DeepSeek, and custom endpoints
- **Persistent memory** — long-term JSON filesystem store, auto-loaded across sessions
- **Session checkpointing** — SQLite-backed conversation history with full resume support
- **Skills system** — drop-in SKILL.md bundles for domain-specific agent capabilities
- **MCP tool integration** — mount any MCP server as agent tools
- **ACP protocol** — Agent Client Protocol server for IDE integration (VS Code, JetBrains)
- **HITL interrupts** — human-in-the-loop confirmation for file edits and shell commands
- **Scheduled tasks** — cron-style recurring agent jobs
- **Channel connectors** — Feishu, DingTalk, WeChat Work webhook adapters
- **Extensible** — plugin hooks, custom providers, brandable `APP_HOME`

## Installation

```bash
pip install llmrix-hestia
```

Requires Python ≥ 3.11.

## Quick Start

```bash
# Interactive agent REPL
llmrix agent

# With a specific model
llmrix agent --model anthropic:claude-opus-4-6

# Resume a previous session
llmrix agent --session <session-id>
```

## Configuration

Initialize a config file at `~/.llmrix/config.json`:

```bash
llmrix config init
llmrix config show
llmrix config model anthropic:claude-opus-4-6
```

Key environment variables:

| Variable | Description |
|---|---|
| `LLMRIX_CONFIG` | Path to config file (overrides auto-search) |
| `LLMRIX_APP_HOME` | Override runtime home directory (default `~/.llmrix`) |
| `LLMRIX_APP_NAME` | Override app name (default `hestia`) |
| `ANTHROPIC_API_KEY` | Anthropic API key |
| `OPENAI_API_KEY` | OpenAI API key |

## CLI Reference

```
llmrix help                       Show help
llmrix version                    Show version
llmrix agent                      Start interactive REPL
llmrix sessions [N]               List recent sessions
llmrix skill list                 List available skills
llmrix config show                Show current config
llmrix config model [MODEL]       View or set default model
llmrix config mcp list            List MCP servers
llmrix config channel list        List channel connectors
llmrix-devtool                        Start ACP agent server
```

## ACP Server

llmrix-hestia ships an [Agent Client Protocol](https://agentclientprotocol.com) server for IDE integration:

```bash
llmrix-devtool
```

## License

Proprietary. See [LICENSE](LICENSE) for details.
