Simplicity is the Ultimate Foundation

Cud is a local-first, multi-agent framework designed to be lightweight and intuitive.
Bring the power of autonomous AI agents directly to your machine with Ollama and DeepAgents.

Quick Start View on GitHub

Core Principles

Simplicity First

No convoluted setups or bloated abstractions. Intuitive and easy to hack on.

Local & Private

Powered by Ollama. Your data, prompts, and memory stay 100% on your machine.

Multi-Agent

Create a fleet of specialized agents, each with its own persona and memory.

Transparent

Behavior is defined in plain Markdown (AGENT.md). No black boxes.

Tool-Rich

Persistent shell sessions, surgical filesystem operations, and MCP support.

Daemon-Ready

Seamlessly run your agents as background services using systemd.

Interaction & Commands

Skills & MCP

Extend capabilities with portable skills and MCP servers.

# Add MCP server cud mcp add researcher https://... --name search # Skill Definition (SKILL.md) # Drop it in agent/workspace/skills/

Periodic Tasks

Run scheduled tasks autonomously using cron expressions.

# Task Definition (TASK.md) # Drop it in agent/workspace/tasks/ --- schedule: "0 8 * * *" channel_id: 123456789 --- Generate daily report

Context Compression

Automatic summarization prevents context limits. Full history is saved to the workspace.

# Agents can manually compress context: Action: call compact_conversation

Discord Gateway

Interact with your agents through Discord slash commands.

Slash Commands

/newStart a fresh session context
/model <name>Switch agent's configured model
/memory viewView the agent's long-term MEMORY.md
/memory clearClear the agent's long-term MEMORY.md
/usageShow runtime usage and agent details
/reloadReload tools and system prompt

Getting Started

Requirements

Ensure you have Ollama running with a tool-calling capable model.

ollama run gemma4:e4b

Installation

pipx install git+https://github.com/arrase/cud.git

Create & Run Agent

Initialize an agent and start the Discord gateway.

cud agent create researcher
cud agent config researcher --model gemma4:e4b
cud gateway setup researcher discord --token YOUR_TOKEN
cud gateway start researcher