Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
77 changes: 77 additions & 0 deletions .claude/context/services-catalog.md
Original file line number Diff line number Diff line change
Expand Up @@ -195,6 +195,48 @@ Comprehensive reference of all production services, ports, APIs, and integration
- **Dependencies:** Open Notebook, LangExtract, Extract Worker
- **Compose Profile:** `orchestration`

## GPU & Compute Services

### GPU Orchestrator
- **Ports:** 8200
- **Purpose:** VRAM management, model lifecycle, and GPU priority queue
- **Key APIs:**
- `GET /healthz` - Service health
- `GET /models` - List loaded models
- `POST /models/load` - Load model to GPU
- `POST /models/unload` - Unload model from GPU
- **Features:**
- Multi-model VRAM allocation
- Priority queue for GPU compute requests
- Automatic model eviction on VRAM pressure
- Integration with Ollama, vLLM, TTS backends
- **Environment:**
- `GPU_ORCHESTRATOR_MAX_MODELS=3` - Max concurrent models
- `GPU_ORCHESTRATOR_VRAM_THRESHOLD=0.9` - Eviction threshold
- `OLLAMA_BASE_URL`, `VLLM_BASE_URL`, `TTS_BASE_URL`
- **Dependencies:** NATS (optional)
- **Compose Profile:** `gpu`
- **Env Tier:** `env-tier-api`

### E2B Runner (pmz-e2b-runner)
- **Ports:** 7071
- **Purpose:** Isolated code execution sandbox (self-hosted)
- **Key APIs:**
- `GET /health` - Service health
- `POST /execute` - Execute code in sandbox
- **Features:**
- Secure code execution in isolated containers
- Python, JavaScript, shell code support
- MCP gateway integration for tool access
- GPU support on ai-lab runner (optional)
- **Deployment:**
- **ai-lab:** Self-hosted with GPU access
- **VPS/proxmox:** CPU-only mode
- **Environment:**
- `E2B_API_KEY` - E2B API key (if using cloud fallback)
- `MCP_GATEWAY_URL` - Docker MCP gateway endpoint
- **Compose Profile:** `workers`, `botz`

## Utility & Integration Services

### Presign
Expand Down Expand Up @@ -306,6 +348,41 @@ Comprehensive reference of all production services, ports, APIs, and integration
- **Stores:** Videos, audio, images, analysis results
- **Compose Profile:** Default (always required)

## External Integrations (Optional)

### Firefly III
- **Ports:** 8080 (internal only - not published to host)
- **Container:** `cataclysm-firefly`
- **Purpose:** Personal finance management and budgeting
- **Key APIs:**
- `GET /api/v1/about` - Version and instance info
- `GET /api/v1/accounts` - List accounts
- `GET /api/v1/transactions` - List transactions
- **Authentication:** OAuth2 Personal Access Token (Bearer token)
- **Dependencies:** Supabase (via `finance_*` tables)
- **Related Tables:**
- `finance_accounts` - Account records
- `finance_budgets` - Budget tracking
- `finance_transactions` - Transaction history
- **n8n Workflows:** `pmoves/integrations/firefly-iii/*.json`
- **Documentation:** https://docs.firefly-iii.org/firefly-iii/api
- **Note:** Internal service, access via Docker network or reverse proxy

### wger (Health Tracking)
- **Container:** `cataclysm-wger`
- **Purpose:** Fitness and workout tracking
- **Related Tables:**
- `health_nutrition` - Nutrition logs
- `health_weight` - Weight tracking
- `health_workouts` - Workout records
- **n8n Workflows:** `pmoves/integrations/health-wger/*.json`

### Jellyfin
- **Container:** `cataclysm-jellyfin`
- **Purpose:** Media server and library management
- **Integration:** `pmoves-jellyfin-bridge` (port 8093) syncs events to Supabase
- **Related Submodules:** `PMOVES-Jellyfin`, `Pmoves-Jellyfin-AI-Media-Stack`

## Quick Reference

### All Service Health Endpoints
Expand Down
2 changes: 1 addition & 1 deletion PMOVES-BoTZ
Submodule PMOVES-BoTZ updated 34 files
+254 −0 .claude/CLAUDE.md
+40 −0 .claude/commands/botz/mcp-catalog.md
+39 −0 .claude/commands/botz/start.md
+35 −0 .claude/commands/botz/status.md
+51 −0 .claude/commands/cipher/recall.md
+49 −0 .claude/commands/cipher/status.md
+49 −0 .claude/commands/cipher/store.md
+58 −0 .claude/commands/glancer/status.md
+49 −0 features/agent_sdk/__init__.py
+33 −0 features/agent_sdk/hooks/__init__.py
+214 −0 features/agent_sdk/hooks/audit.py
+302 −0 features/agent_sdk/hooks/cost_tracker.py
+238 −0 features/agent_sdk/hooks/nats_publisher.py
+625 −0 features/agent_sdk/pmoves_agent.py
+476 −0 features/agent_sdk/session_manager.py
+34 −0 features/agent_sdk/subagents/__init__.py
+342 −0 features/agent_sdk/subagents/code_reviewer.py
+411 −0 features/agent_sdk/subagents/knowledge_manager.py
+335 −0 features/agent_sdk/subagents/media_processor.py
+225 −0 features/agent_sdk/subagents/researcher.py
+1 −1 features/cipher/pmoves_cipher
+61 −0 features/gateway/docker-compose.yml
+1 −0 features/glancer
+39 −0 features/mcp_bridge/Dockerfile
+43 −0 features/mcp_bridge/__init__.py
+39 −0 features/mcp_bridge/docker-compose.yml
+4 −0 features/mcp_bridge/requirements.txt
+320 −0 features/mcp_bridge/server.py
+23 −0 features/mcp_bridge/tools/__init__.py
+253 −0 features/mcp_bridge/tools/hirag.py
+272 −0 features/mcp_bridge/tools/nats.py
+342 −0 features/mcp_bridge/tools/supabase.py
+311 −0 features/mcp_bridge/tools/tensorzero.py
+1 −0 features/n8n/n8n-mcp
2 changes: 1 addition & 1 deletion docs/PMOVES_Git_Organization.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ This document provides a comprehensive guide to PMOVES.AI's GitHub organization,

## Contributor Guidance
- Operational/stabilization rules live in the root `AGENTS.md`; service-level coding norms for the `pmoves/` subtree live in `pmoves/AGENTS.md`. Read both before opening PRs and keep edits in sync.
- Submodules are the source of truth for hardened integrations (Archon, Agent Zero, PMOVES.YT, etc.). Pin the intended branch/ref in `.gitmodules`, align with `docs/PMOVES.AI-Edition-Hardened.md`, and note any temporary divergence in PR notes.
- Submodules are the source of truth for hardened integrations (Archon, Agent Zero, PMOVES.YT, etc.). Pin the intended branch/ref in `.gitmodules`, align with `docs/PMOVES.AI-Edition-Hardened-Full.md`, and note any temporary divergence in PR notes.

## GitHub Actions Self-Hosted Runner Setup

Expand Down
1 change: 1 addition & 0 deletions pmoves/.gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -44,3 +44,4 @@ data/jellyfin/
data/open-notebook/
data/chit/
cloudflared/
pmoves/data/agent-zero/
Loading
Loading