Open Source · Self-Hosted · Always Running

OpenCeph 🐙

Your Autonomous AI Staff.

Deploy intelligent tentacles that work 24/7 — monitoring, researching, and acting on your behalf. Not an assistant you summon. A staff that never stops.

openceph — daemon
$ openceph start
▸ Brain daemon started on port 18789
▸ Loading tentacles...
[hn-radar] scanning HackerNews...
[competitor-watch] monitoring 12 repos
[daily-briefing] next run: 07:00 UTC
[github-monitor] watching 5 repos
▸ 4 tentacles active
$
24/7
Always Running
Tentacle Skills
<1s
Response Time
100%
Open Source

What Makes OpenCeph Different

🐙

Autonomous Tentacles

Deploy AI agents that run 24/7 in the background. They know their responsibilities and act independently.

🧠

Brain Daemon

A central intelligence that coordinates all tentacles, manages memory, and makes decisions across your staff.

⏱️

Heartbeat Scheduler

Cron-like scheduling for tentacles. Set frequencies from minutes to weeks. Runs even when your computer is off.

👁️

Proactive, Not Reactive

Your tentacles don't wait to be asked. They monitor, detect changes, and report only what matters.

🔌

Skill Tentacle Protocol

Write tentacles in any language — Python, TypeScript, or any executable. Standard IPC protocol for all.

🛡️

Self-Hosted & Private

Everything runs on your machine or VPS. Your data never leaves your infrastructure. Fully open source.

How It Works

01

Install & Configure

Clone the repo, set your API keys, and start the daemon. One command to boot your AI staff.

02

Deploy Tentacles

Install skill tentacles from the community or write your own. Each tentacle has a clear mission.

03

They Work, You Sleep

Tentacles run on their heartbeat schedule. They monitor, analyze, and act. Only important findings reach you.

What Your Tentacles Can Do

Each tentacle is a specialist. Deploy as many as you need.

📡
MonitoringIntel

Competitor Radar

Monitor competitor repos, products, and announcements 24/7. Get alerted only when something matters.

🔍
GrowthCommunity

HN/Reddit Signal Hunter

Scan communities for potential users, relevant discussions, and market signals. Draft outreach automatically.

📬
Productivity

Daily Briefing Daemon

Aggregate email, Slack, calendar, and news into one morning briefing. Delivered before you wake up.

🔀
DevOpsSecurity

GitHub Monitor

Watch repos for important PRs, security issues, and dependency updates. Triage issues by priority.

📈
FinanceCrypto

Market Signal Watch

24/7 monitoring of market anomalies, on-chain data, and trading signals. Acts on your strategy.

🧬
ResearchML

Auto-Researcher

Run experiment loops, benchmark models, record results, and adjust strategy. Autonomous science.

Built for Autonomy

architecture.txt
┌──────────────────────────────────┐
│         Gateway Layer              │
│   Feishu · Discord · Slack · API │
└──────────────┬───────────────────┘
               │
┌──────────────▼───────────────────┐
│        Brain Daemon               │
│  ┌─────────┐ ┌────────────────┐  │
│  │ Memory  │ │ LLM Gateway   │  │
│  └─────────┘ └────────────────┘  │
│  ┌─────────┐ ┌────────────────┐  │
│  │ Scheduler│ │ Tool Registry │  │
│  └────┬────┘ └────────────────┘  │
└───────┼──────────────────────────┘
        │  IPC (stdin/stdout)
  ┌─────▼─────┬─────────┬─────────┐
  │ Tentacle  Tentacle  Tentacle │
  │ hn-radarcompetitorbriefing │
  │  Python  │    TS   │  Python  │
  └──────────┴─────────┴──────────┘

🧠 Brain = Central Intelligence

The brain daemon is the always-on coordinator. It manages memory, schedules tentacles, routes messages through gateways, and makes cross-tentacle decisions.

🐙 Tentacles = Specialist Workers

Each tentacle is a subprocess with a clear mission. Written in any language. Communicates via standardized IPC protocol. Isolated, replaceable, composable.

⏱️ Heartbeat = The Clock

Cron-like scheduler that wakes tentacles at their configured frequency. From every 5 minutes to once a week. Resilient to restarts.

💬 Gateway = Your Interface

Connect via Feishu, Discord, Slack, WhatsApp, or raw API. Multiple gateways can run simultaneously.

Works With Everything

Claude
LLM
GPT
LLM
Feishu
Gateway
Discord
Gateway
Slack
Gateway
WhatsApp
Gateway
Python
Tentacle
TypeScript
Tentacle

Up and Running in 60 Seconds

terminal
# Clone the repo
$ git clone https://github.com/YuxuanSha/openceph.git
# Install dependencies
$ cd openceph && npm install
# Configure your API keys
$ cp .env.example .env && vim .env
# Start the daemon
$ npm run start
▸ OpenCeph is running. Your tentacles are awake.

Read the full documentation ↗

Stop Doing Manually

Your first tentacle is one git clone away. Join the developers building their autonomous AI staff.