Files
Orchestrator/shared/AI-Orchestrator/SETUP_TODO.md
T
ankn a5f8fb49ab Migrate all repos into monorepo context folders
Bahn: aisupport, Analyse-O2C-C2S, awesome-bahn-mcp-servers, beam-mcp,
      Confluence_Bot, db-planet-mcp-server, O2C-Harness, project-audit,
      Projekt-KIQ-HP, teamlandkarte-mcp
Dhive: Jury-Voting
Privat: CV, NoteGraph (NOTE: NoteGraph needs complete redo after consolidation)
Shared: AI-Orchestrator, OrgMyLife, power_skills_and_more
Shared/references: symphony (read-only)

Bahn repos remain available as independent remotes - this monorepo
pulls them in via subtree, the originals are untouched.
2026-06-30 20:39:52 +02:00

97 lines
2.8 KiB
Markdown

# Setup TODO — Getting AI-Orchestrator + OrgMyLife Running
## Prerequisites
- [x] **Python 3.11+** installed on your machine
- [x] **PostgreSQL** running (Docker on VPS)
- [ ] **Codex CLI** installed (`codex app-server` must be available in PATH)
- [x] **Git** available in PATH
---
## 1. OrgMyLife Setup (Your Task Board) ✅ DONE
- [x] PostgreSQL running in Docker on VPS
- [x] `.env` configured with all credentials
- [x] App deployed and running at https://api.andreknie.de
- [x] Login page working (session-based auth)
- [x] Nextcloud calendar sync working
- [x] Nextcloud ToDo sync working (two-way)
- [x] Email/IMAP sync working
- [x] Backlog.md sync working
- [x] Delete button, AI toggle, sort buttons in UI
---
## 2. AI-Orchestrator Setup (NEXT)
### Install
- [ ] `cd AI-Orchestrator && pip install -e ".[dev]"`
### Configure
- [ ] Copy the OrgMyLife workflow file:
```bash
cp WORKFLOW.orgmylife.md WORKFLOW.md
```
- [ ] Edit `WORKFLOW.md`:
- `tracker.endpoint` → `https://api.andreknie.de`
- `tracker.api_key` → your `API_SECRET` from the VPS .env
- `workspace.root` → where you want agent workspaces locally
- `codex.command` → your agent CLI command
### Verify Agent CLI
- [ ] Confirm your coding agent works:
```bash
codex --version
```
- [ ] If using a different agent (Claude, local LLM), update `codex.command`
### Run
- [ ] Start the orchestrator:
```bash
ai-orchestrator WORKFLOW.md --port 8080
```
- [ ] Check the dashboard: http://localhost:8080
- [ ] Verify it connects to OrgMyLife (check logs)
---
## 3. End-to-End Test
- [ ] Mark a coding task as agent_ready (🤖 button in UI)
- [ ] Watch the orchestrator pick it up
- [ ] Verify the agent creates a workspace and starts working
- [ ] Check that OrgMyLife shows the task as "in_progress"
- [ ] When the agent finishes, verify the task moves to "completed"
---
## 4. Optional Enhancements
- [x] Add authentication to OrgMyLife (login page + API_SECRET for orchestrator)
- [x] Add 🤖 indicator in OrgMyLife frontend for agent_ready tasks
- [ ] Set up the orchestrator as a systemd service or Docker container
- [ ] Configure workspace hooks to clone repos automatically
- [ ] Set up auto-sync (cron) on the VPS
- [ ] Set up email notifications when agents complete tasks
---
## Quick Reference
| Service | URL | Purpose |
|---------|-----|---------|
| OrgMyLife | https://api.andreknie.de | Your task board + data source |
| AI-Orchestrator | http://localhost:8080 | Agent dispatch + monitoring |
| Orchestrator API | http://localhost:8080/api/v1/state | JSON system state |
| Command | What it does |
|---------|--------------|
| `docker compose up -d --build` | Rebuild & restart OrgMyLife on VPS |
| `ai-orchestrator WORKFLOW.md --port 8080` | Start orchestrator locally |
| `git pull && docker compose up -d --build` | Deploy updates to VPS |