donkit-ragops-ce 0.1.2

Community Edition CLI agent for building RAG pipelines

RagOps Agent CE (Community Edition)

An LLM-powered CLI agent that automates the creation and maintenance of Retrieval-Augmented Generation (RAG) pipelines. The agent orchestrates built-in tools and Model Context Protocol (MCP) servers to plan, chunk, and load documents into vector stores.

Built by Donkit AI - Open Source RAG Infrastructure.

Key Features

• Interactive REPL — Start an interactive session with readline history and autocompletion
• Checklist-driven workflow — The agent creates project checklists, asks for approval before each step, and tracks progress
• Multi-language support — Automatically detects and responds in the user's language
• Session-scoped checklists — Only current session checklists appear in the UI
• Integrated MCP servers — Built-in support for planning, chunking, and vector loading
• Docker Compose orchestration — Automated deployment of RAG infrastructure (Qdrant, RAG service)
• Multiple LLM providers — Supports Vertex AI, OpenAI, Azure OpenAI, Anthropic Claude, Ollama

Installation

From PyPI

pip install donkit-ragops-ce

Quick Start

1. Configure your LLM provider:

# Choose provider: 'vertexai', 'openai', 'anthropic', 'ollama'
export RAGOPS_LLM_PROVIDER=vertexai

# Vertex AI (Google Cloud)
export RAGOPS_VERTEX_CREDENTIALS=/path/to/service_account.json

# Or OpenAI
export RAGOPS_OPENAI_API_KEY=sk-...

# Or Anthropic
export RAGOPS_ANTHROPIC_API_KEY=sk-ant-...

# Or Ollama (local)
export RAGOPS_OLLAMA_BASE_URL=http://localhost:11434

2. Start the agent:

donkit-ragops-ce

3. Tell the agent what you want:

you> Create a RAG pipeline for my documentation in /path/to/docs

The agent will automatically:

• Create a project structure
• Generate a configuration plan
• Chunk your documents
• Set up Docker Compose with Qdrant and RAG service
• Load data into the vector store

Usage

Note: The command ragops-agent is also available as an alias for backward compatibility.

The agent starts in interactive REPL mode by default. Use subcommands like ping for specific actions.

Interactive Mode (REPL)

# Start interactive session
donkit-ragops-ce

# With specific provider
donkit-ragops-ce -p vertexai

# With custom model
donkit-ragops-ce -p openai -m gpt-4

Command-line Options

• -p, --provider — Override LLM provider from settings
• -m, --model — Specify model name
• -s, --system — Custom system prompt
• --show-checklist/--no-checklist — Toggle checklist panel (default: shown)
• --mcp-command — Add custom MCP server (can be used multiple times)

Subcommands

# Health check
donkit-ragops-ce ping

Environment Variables

• RAGOPS_LLM_PROVIDER — LLM provider name
• RAGOPS_LOG_LEVEL — Logging level (default: INFO)
• RAGOPS_MCP_COMMANDS — Comma-separated list of MCP commands
• RAGOPS_VERTEX_CREDENTIALS — Path to Vertex AI service account JSON
• RAGOPS_OPENAI_API_KEY — OpenAI API key
• RAGOPS_ANTHROPIC_API_KEY — Anthropic API key
• RAGOPS_OLLAMA_BASE_URL — Ollama server URL

Agent Workflow

The agent follows a structured workflow:

1. Language Detection — Detects user's language from first message
2. Project Creation — Creates project directory structure
3. Checklist Creation — Generates task checklist in user's language
4. Step-by-Step Execution:
   • Asks for permission before each step
   • Marks item as in_progress
   • Executes the task using appropriate MCP tool
   • Reports results
   • Marks item as completed
5. Deployment — Sets up Docker Compose infrastructure
6. Data Loading — Loads documents into vector store

MCP Servers

RagOps Agent CE includes built-in MCP servers:

ragops-rag-planner

Plans RAG pipeline configuration based on requirements.

# Example usage
donkit-ragops-ce --mcp-command "ragops-rag-planner"

Tools:

• plan_rag_config — Generate RAG configuration from requirements

ragops-chunker

Chunks documents for vector storage.

# Example usage
donkit-ragops-ce --mcp-command "ragops-chunker"

Tools:

• chunk_documents — Split documents into chunks with configurable strategies
• list_chunked_files — List processed chunk files

ragops-vectorstore-loader

Loads chunks into vector databases.

# Example usage
donkit-ragops-ce --mcp-command "ragops-vectorstore-loader"

Tools:

• vectorstore_load — Load documents into Qdrant, Chroma, or Milvus
• delete_from_vectorstore — Remove documents from vector store

ragops-compose-manager

Manages Docker Compose infrastructure.

# Example usage
donkit-ragops-ce --mcp-command "ragops-compose-manager"

Tools:

• init_project_compose — Initialize Docker Compose for project
• compose_up — Start services
• compose_down — Stop services
• compose_status — Check service status
• compose_logs — View service logs

ragops-checklist

Manages project checklists and progress tracking.

Tools:

• create_checklist — Create new checklist
• get_checklist — Get current checklist
• update_checklist_item — Update item status

Examples

Basic RAG Pipeline

donkit-ragops-ce

you> Create a RAG pipeline for customer support docs in ./docs folder

The agent will:

1. Create project structure
2. Plan RAG configuration
3. Chunk documents from ./docs
4. Set up Qdrant + RAG service
5. Load data into vector store

Custom Configuration

donkit-ragops-ce -p vertexai -m gemini-1.5-pro

you> Build RAG for legal documents with 1000 token chunks and reranking

Multiple Projects

Each project gets its own:

• Project directory (projects/<project_id>)
• Docker Compose setup
• Vector store collection
• Configuration

Development

Project Structure

donkit-ragops-ce/
├── src/ragops_agent_ce/
│   ├── agent/          # LLM agent core
│   ├── llm/            # LLM provider integrations
│   ├── mcp/            # MCP servers and client
│   │   └── servers/    # Built-in MCP servers
│   ├── cli.py          # CLI commands
│   └── config.py       # Configuration
├── tests/
└── pyproject.toml

Running Tests

poetry run pytest

Code Quality

# Format code
poetry run ruff format .

# Lint code
poetry run ruff check .

Docker Compose Services

The agent can deploy these services:

Qdrant (Vector Database)

services:
  qdrant:
    image: qdrant/qdrant:latest
    ports:
      - "6333:6333"
      - "6334:6334"

RAG Service

services:
  rag-service:
    image: donkit/rag-service:latest
    ports:
      - "8000:8000"
    environment:
      - DATABASE_URI=http://qdrant:6333
      - CONFIG=<base64-encoded-config>

Architecture

┌─────────────────┐
│  RagOps Agent   │
│     (CLI)       │
└────────┬────────┘
         │
         ├── MCP Servers ───────────────┐
         │   ├── ragops-rag-planner     │
         │   ├── ragops-chunker         │
         │   ├── ragops-vectorstore     │
         │   └── ragops-compose         │
         │                              │
         └── LLM Providers ─────────────┤
             ├── Vertex AI              │
             ├── OpenAI                 │
             ├── Anthropic              │
             └── Ollama                 │
                                        │
                                        ▼
                            ┌──────────────────┐
                            │ Docker Compose   │
                            ├──────────────────┤
                            │ • Qdrant         │
                            │ • RAG Service    │
                            └──────────────────┘

Troubleshooting

MCP Server Connection Issues

If MCP servers fail to start:

# Check MCP server logs
RAGOPS_LOG_LEVEL=DEBUG donkit-ragops-ce

Vector Store Connection

Ensure Docker services are running:

cd projects/<project_id>
docker-compose ps
docker-compose logs qdrant

Credentials Issues

Verify your credentials:

# Vertex AI
gcloud auth application-default print-access-token

# OpenAI
echo $RAGOPS_OPENAI_API_KEY

Contributing

We welcome contributions! Please see CONTRIBUTING.md for details.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Support

• Documentation: https://docs.donkit.ai
• GitHub Issues: https://github.com/donkit-ai/donkit-ragops-ce/issues
• Community: https://discord.gg/donkit

Related Projects

• donkit-chunker — Document chunking library
• donkit-vectorstore-loader — Vector store loading utilities
• donkit-read-engine — Document parsing engine

---

Built with ❤️ by Donkit AI