Metadata-Version: 2.4
Name: llmrix-hestia
Version: 0.2.10
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.8,>=0.7.11
Requires-Dist: langgraph<1.3,>=1.2.11
Requires-Dist: langgraph-checkpoint<5,>=4.2.0
Requires-Dist: langgraph-checkpoint-sqlite<4,>=3.1.1
Requires-Dist: langgraph-prebuilt>=1.1.0
Requires-Dist: langchain>=1.3.18
Requires-Dist: langchain-core>=1.6.1
Requires-Dist: langchain-openai<2,>=1.6.0
Requires-Dist: langchain-anthropic>=1.7.0
Requires-Dist: langchain-mcp-adapters<0.4,>=0.3.2
Requires-Dist: langchain-quickjs>=0.3.5
Requires-Dist: rich>=15.0.0
Requires-Dist: pydantic<3,>=2.13.5
Requires-Dist: python-dotenv<2,>=1.2.3
Requires-Dist: agent-client-protocol<0.13,>=0.12.1
Requires-Dist: deepagents-acp<0.1,>=0.0.11
Requires-Dist: apscheduler[sqlalchemy]>=3.11.3
Requires-Dist: bcrypt>=5.0.0
Requires-Dist: httpx>=0.28.1
Requires-Dist: fastapi>=0.141.1
Requires-Dist: sse-starlette<3.4.7,>=3.4.6
Requires-Dist: uvicorn<1,>=0.52.4
Requires-Dist: sqlalchemy<3,>=2.0.52
Requires-Dist: aiosqlite>=0.22.1
Requires-Dist: pyyaml>=6.0.3
Requires-Dist: pillow>=12.3.0
Requires-Dist: lxml<7,>=6.1.2
Requires-Dist: openpyxl>=3.1.0
Requires-Dist: pypdf<7,>=6.16.2
Requires-Dist: pdfplumber>=0.11.10
Requires-Dist: pdf2image>=1.17.0
Requires-Dist: defusedxml>=0.7.1
Requires-Dist: langfuse==4.14.2
Requires-Dist: lark-oapi<2,>=1.7.3
Requires-Dist: keyring>=25.7.0
Requires-Dist: sqlite-vec>=0.1.9
Provides-Extra: cloud
Requires-Dist: asyncpg>=0.31.0; extra == "cloud"
Requires-Dist: psycopg2-binary>=2.9.12; extra == "cloud"
Requires-Dist: pgvector<0.5,>=0.4.2; extra == "cloud"
Requires-Dist: langgraph-checkpoint-postgres<4,>=3.1.2; extra == "cloud"
Requires-Dist: langgraph-checkpoint-redis<0.5,>=0.4.1; extra == "cloud"
Requires-Dist: redis>=5.0.0; extra == "cloud"
Requires-Dist: oss2>=2.19.1; extra == "cloud"
Requires-Dist: langchain-daytona>=0.0.8; extra == "cloud"
Requires-Dist: docker>=7.2.0; extra == "cloud"
Provides-Extra: sandbox-daytona
Requires-Dist: langchain-daytona>=0.0.8; extra == "sandbox-daytona"
Provides-Extra: sandbox-docker
Requires-Dist: docker>=7.2.0; extra == "sandbox-docker"
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
Requires-Dist: ruff>=0.9; extra == "dev"
Provides-Extra: router
Requires-Dist: litellm!=1.82.7,!=1.82.8,<2.0.0,>=1.94.1; extra == "router"
Requires-Dist: langchain-litellm>=0.7.0; extra == "router"
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.

The default installation is the local/native runtime and does not install
external PostgreSQL or Redis clients. Install cloud storage, shared cache and
remote integrations explicitly when deploying the cloud runtime:

```bash
pip install "llmrix-hestia[cloud]"
```

Sandbox providers are independently selectable:

```bash
pip install "llmrix-hestia[sandbox-docker]"    # local Docker sandbox
pip install "llmrix-hestia[sandbox-daytona]"   # Daytona cloud sandbox
```

## 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.
