CEO HUB — Documentation

⚡ Quickstart

CEO HUB is a self-hosted multi-tenant AI agent platform. Install it on a single Ubuntu 22.04 / Debian 12 server with one command:

# Free tier (1 project, no key needed)
curl -fsSL https://ceo.augur.news/install.sh | bash

# Or with license (Starter / Pro / Enterprise)
curl -fsSL https://ceo.augur.news/install.sh | bash -s -- --license=YOUR-KEY

After install completes (≈5 minutes), open http://YOUR-SERVER/hub/. You'll see an onboarding wizard.

Requirements: Ubuntu 22.04+ / Debian 12+ · 4 GB RAM · 20 GB disk · root access. Internet not required to operate (Ollama runs locally).

📁 Projects

Each "project" is an isolated context — its own ICP, value proposition, leads, mail drafts, and brand. Run multiple businesses or product lines from one HUB.

Adding a project

Sidebar (top-left) → Active Project dropdown → + button
Fill name, slug, website, industry, ICP
Wizard creates folders under /var/lib/augur/projects/<slug>/
Open Projects tab → edit CONTEXT.md (this is the project's brain — agents read it)

CONTEXT.md anatomy

# Project Name

## Tek Cümle
What this project does in one sentence.

## ICP (Ideal Customer Profile)
Who, where, how big.

## Value Prop
Why they buy.

## Tone of Voice
How you sound.

Agents inject this whenever they generate emails or research leads for your project.

🤖 Agents

CEO HUB runs 13 agents on a shared Ollama LLM (default: qwen2.5:7b). Each agent has a system prompt under /opt/ceo-runner/prompts/ — editable from Settings → Agent Prompt Editor.

Agent	Role	Triggered by
research	Find leads, do deep dives	"araştır", "find", lead bulma
web_research	Browser-based research	"derin profil"
marketing	Email drafts, copy	"mail draftla", "kampanya"
sales	Call scripts, proposals	"satış", "teklif"
engineer	Code/feature implementation	"kod yaz", "fix bug"
engineer_system	System-level Aider edits	HUB self-improve
docs	Documentation, proposals	"yaz", "doc"
finance	Cost analysis, invoicing	"maliyet", "bütçe"
legal	NDA, KVKK, compliance	"hukuki", "KVKK"
data	Analytics, queries	"analiz", "rapor"
pm	Self-improvement loop	otomatik / "/gelistir"
system	Critical fixes	health alert
ceo	Strategy, OKR	"strateji", "OKR"

📧 Mail

Drafts flow: research finds leads → marketing creates drafts → designer renders HTML → you approve → push to Listmonk → real send.

Listmonk routing

Each project can have its own Listmonk list. Configure mapping at /var/lib/augur/projects/_listmonk_lists.json:

{
  "augur": { "list_id": 3, "name": "Augur B2B" },
  "turqix": { "list_id": 5, "name": "Turqix B2B" }
}

Or click 📋 Listmonk on the project card and HUB creates the list for you.

💼 Sales

Sales tab is your CRM-lite:

Status workflow: new → contacted → replied → won/lost
ICP% column auto-calculates fit vs project CONTEXT
Tag leads to multiple projects (each lead can belong to many)
Bulk actions: tag, untag, status change, mission compose
CSV import/export per project

⚙️ Admin

License tiers

Tier	Max Projects	Yearly
Free	1	$0
Starter	3	$499
Pro	10	$1,499
Enterprise	∞	$4,999+

License key lives at /etc/augur/license.json. To upgrade, contact hello@ceo.augur.news.

Supabase service_role key

For full database write access (delete, update, manual lead add), you need a service_role JWT. Get it from Supabase Dashboard → Settings → API → service_role secret. Paste into Settings → 🔑 Supabase Service Key. HUB auto-restarts.

Backups

Runs automatically via cron at 03:00. Trigger manually from Settings → 💾 Manual backup.

🔌 API

Backend: localhost:8770, proxied by nginx as /api/cockpit/*. All endpoints return JSON.

Core endpoints

GET  /api/cockpit/projects/list
POST /api/cockpit/projects/select         {slug}
GET  /api/cockpit/projects/active
GET  /api/cockpit/projects/kpi/<slug>
GET  /api/cockpit/leads/list?project=<slug>
GET  /api/cockpit/drafts/list?project=<slug>
POST /api/cockpit/mission/compose          {department, task, project}
POST /api/cockpit/lead/quick_add           {slug, data}
POST /api/cockpit/lead/tag_project         {lead_id, slug}
POST /api/cockpit/draft/redesign           {id, project}
GET  /api/cockpit/system_info
GET  /api/cockpit/today_summary
GET  /api/cockpit/search?q=<keyword>

Full spec: GET /api/cockpit/spec

🩺 Troubleshooting

Mail tab boş görünüyor

Aktif projeyi değiştirdin mi? Default "Aktif proje" filtresi sadece o projenin draftlarını gösterir
📚 Tüm projeler checkbox işaretle
F12 → Console → fetch hatası var mı?

RLS hatası — INSERT/UPDATE/DELETE 401

Supabase anon key sadece okuma yetkili. service_role key ekle (yukarıda anlatıldı).

Mission processing'de takılı

systemctl restart ceo-crew-dispatcher

Disk doluyor

Backup ve done mission'lar birikiyor. Cron temizlik:

/opt/augur-deploy/mission-retention.sh

Ollama yavaş

qwen2.5:7b RAM yer ~6GB. Daha hızlı bir model için Settings → Models → 4B'ye düş.

❓ FAQ

Internet'siz çalışır mı?

Evet. Ollama local. Mail göndermek için Brevo/SMTP gerekli (opsiyonel).

Birden fazla kullanıcı?

Şu anda tek-admin. Multi-user 2026 Q3 roadmap'te.

Veri Türkiye'de mi kalır?

Senin sunucun nerede ise. Supabase host'una bağlı.

Augur yerine başka isim kullanabilir miyim?

Evet, Enterprise tier'da white-label. /etc/augur/branding.json ile özelleştirilir.

Lisans iptali?

14 gün para iade. Sonra yıllık devam. hello@ceo.augur.news