CLIver

Install gateway dependencies

pip install cliver[telegram]

Install via pip

pip install cliver

Or run with Docker

docker run --rm -it --user $UID:0 -v ~/.cliver:/home/cliver/.cliver \ -e DEEPSEEK_API_KEY ghcr.io/cliver-project/cliver

Or use Docker

docker run -e TELEGRAM_BOT_TOKEN -e OPENAI_API_KEY \ ghcr.io/cliver-project/cliver:latest gateway telegram ```

Quick Start

```bash

~/.cliver/config.yaml

providers: minimax: type: openai api_url: https://api.minimaxi.com/v1 api_key: '{{ keyring("cliver", "minimax.api_key") }}' rate_limit: requests: 1500 period: 5h margin: 0.1 image_url: https://api.minimaxi.com/v1/image_generation image_model: image-01 models: - MiniMax-M2.7 minimax-anthropic: type: anthropic api_url: https://api.minimaxi.com/anthropic api_key: '{{ keyring("cliver", "minimax.api_key") }}' rate_limit: requests: 1500 period: 5h margin: 0.1 image_url: https://api.minimaxi.com/v1/image_generation image_model: image-01 models: - MiniMax-M2.7 deepseek-anthropic: type: anthropic api_url: https://api.deepseek.com/anthropic api_key: "{{ env.DEEPSEEK_API_KEY }}" models: - deepseek-v4-flash deepseek-openai: type: openai api_url: https://api.deepseek.com api_key: "{{ env.DEEPSEEK_API_KEY }}" models: - deepseek-v4-flash ```

~/.cliver/config.yaml

mcpServers: filesystem: transport: stdio command: npx args: ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/workspace"] postgres: command: npx args: ["-y", "@modelcontextprotocol/server-postgres", "postgresql://localhost/mydb"] ```

~/.cliver/cliver-settings.yaml

permission_mode: auto-edit

Set up dev environment

make init

Embeddable Python API

Use AgentCore to integrate CLIver's agent capabilities into your own applications.

```python from cliver import AgentCore

MCP Integration

Connect to any Model Context Protocol (MCP) server for extended tool capabilities. File systems, databases, APIs, and more — all through a standardized protocol.

```yaml

Workflows

LangGraph-powered multi-step workflow engine with subagent isolation and pause/resume support. Complex tasks stay on track without scattered, unpredictable behavior.

```python

Workflow definition (Python)

from cliver.workflow import Workflow, WorkflowStep

workflow = Workflow( name="deploy-pipeline", steps=[ WorkflowStep(name="build", agent="builder"), WorkflowStep(name="test", agent="tester", depends_on=["build"]), WorkflowStep(name="deploy", agent="deployer", depends_on=["test"]), ] ) ```