☕ KOPI Agent Documentation

Singapore Coffee × AI — One command to set up your AI assistant

Introduction

KOPI Agent is a deeply customized AI agent platform based on Hermes Agent, built for Singapore and Southeast Asian users. As simple as ordering coffee at a kopitiam — pick your flavor, one command to install.

☕ Why KOPI? In Singapore, KOPI isn't just coffee — it's a culture. From KOPI O (black coffee) to KOPI Siew Dai (less sugar), each order represents a different strength and sweetness. KOPI Agent works the same way: pick the version that suits you.

Product Line

Version	Model	Description
KOPI O Classic	MiMo v2.5 Pro	Classic original, full-featured
KOPI Siew Dai Less Sugar	MiMo v2.5 Pro	Lightweight version, same model, cleaner config
KOPI O Flash	MiMo v2 Flash	Fast version, quicker responses
KOPI Gau Strong	DeepSeek v4 Flash	Strong version, enhanced reasoning

Installation

KOPI O (Classic)

curl -fsSL https://kopiaiagent.com/install.sh | bash

KOPI Siew Dai (Less Sugar)

curl -fsSL https://kopiaiagent.com/install-siew-dai.sh | bash

💡 Installation Process The script automatically handles: OS detection → dependency install → Python check → clone code → create venv → install deps → provision API Key → generate config → pre-install 100+ skills. The last step configures messaging platforms (Telegram / WeChat).

Provide API Key Manually

curl -fsSL https://kopiaiagent.com/install.sh | KOPI_API_KEY=kp-xxx bash

System Requirements

Operating System: Ubuntu 20.04+, Debian 11+, CentOS 8+, Fedora, Arch
Architecture: x86_64 / arm64
Python: 3.11+ (auto-installed by script)
Memory: 1GB+ recommended
Disk: 2GB+ free space
Network: Requires access to kopiaiagent.com

Quick Start

Interactive Chat

kopi

Chat with AI directly in your terminal. Supports tool calls, code execution, file operations, and more.

One-Shot Query

kopi "Write a Python script to batch rename files"

Switch Models

/model kopi-gau       # Switch to DeepSeek strong version
/model kopi-o-flash   # Switch to fast version
/model kopi-o         # Switch back to classic

Common Commands

Command	Description
`kopi`	Start interactive chat
`kopi gateway start`	Start messaging gateway (Telegram/WeChat)
`kopi gateway stop`	Stop messaging gateway
`kopi doctor`	Diagnose issues
`kopi setup`	Full setup wizard
`kopi logs`	View logs
`kopi status`	View status

In-Chat Commands

Command	Description
`/model <name>`	Switch model
`/new`	New conversation
`/skills`	View installed skills
`/memory`	View memory
`/help`	Help

Gateway (Messaging Gateway)

KOPI Agent can interact with you via Telegram and WeChat — use AI like chatting with a friend.

Telegram Setup

Search for @BotFather
Send /newbot to create a Bot
Copy the Token you receive
Run kopi gateway setup and enter the Token

systemd Service

systemctl start kopi-gateway     # Start
systemctl stop kopi-gateway      # Stop
systemctl status kopi-gateway    # Status
journalctl -u kopi-gateway -f    # Logs

Models

All models are proxied through KOPI Proxy — no need to bring your own API Key.

Client Model Name	Upstream Model	Description
`kopi-o`	MiMo v2.5 Pro	Default, strongest overall
`kopi-o-flash`	MiMo v2 Flash	Fast response
`kopi-siew-dai`	MiMo v2.5 Pro	Siew Dai default
`kopi-siew-dai-flash`	MiMo v2 Flash	Siew Dai fast version
`kopi-gau`	DeepSeek v4 Flash	Strong reasoning

Skills

Automatically installs 100+ skills during setup, covering:

Category	Skills	Examples
Core Dev	15	plan, debugging, TDD, code-review
GitHub	6	PR workflow, issues, repo management
Research	6	arXiv, blog monitoring, Jupyter
Productivity	8	Google Workspace, Notion, PowerPoint
Media	5	YouTube, Twitter, Spotify
Creative	8	Architecture diagrams, Comics, Infographics, Pixel art
DevOps	5	Docker, Kanban, CLI
Other	50+	Email, Gaming, Smart home, Red team testing

Configuration

Config file is located at ~/.kopi/config.yaml:

# Model Configuration
model:
  default: kopi-o              # Default model
  provider: custom
  base_url: https://kopiaiagent.com/kp/v1
  api_key: kp-xxxxxxxx         # Auto-provisioned during install
  context_length: 256000

# Agent Configuration
agent:
  max_turns: 90

# Terminal Configuration
terminal:
  timeout: 180

# Display Configuration
display:
  skin: default
  show_cost: true

# Memory Configuration
memory:
  memory_enabled: true
  user_profile_enabled: true

Troubleshooting

Installation Failed

⚠️ Common Issues

dpkg interrupted → Run sudo dpkg --configure -a
Python version too old → Script will auto-install 3.11+
Network issues → Ensure you can reach kopiaiagent.com

API Issues

⚠️ 401 Invalid API Key

Check ~/.kopi/config.yaml api_key in config is correct
Confirm base_url is https://kopiaiagent.com/kp/v1
Run kopi doctor to diagnose

Gateway Issues

⚠️ Telegram Bot Not Responding

Check systemctl status kopi-gateway
Check logs journalctl -u kopi-gateway -f
Confirm Bot Token is correct

✅ Get Help GitHub Issues: github.com/LINYIQ66/kopi-agent