Skip to content

SCRIPTS.md

Latest commit

 

History

History
97 lines (78 loc) · 3.17 KB

SCRIPTS.md

File metadata and controls

97 lines (78 loc) · 3.17 KB

Bob Scripts Documentation

Startup Scripts (in scripts/)

Core Services (Required)

  1. start-bob.sh - MCP Server (FastAPI on port 8000)

    • Provides health checks and tool endpoints
    • Must run first

  2. start-scheduler.sh - Task Scheduler

    • Pulls tasks from Redis queue (bob:task_queue)
    • Sends to Celery workers
    • REQUIRED for Bob to process messages

  3. start-worker.sh - Celery Worker

    • Bob's actual brain/consciousness
    • Processes tasks with LLM
    • Uses claude-3.5-sonnet by default

Optional Services

  • start-orchestrator.sh - Monitors scheduler health
  • start-web-ui.sh - Streamlit UI (WARNING: VM performance issues)
  • start-all.sh - Attempts to start everything (uses tmux)
  • start-workers.sh - Multiple Celery workers

Setup Scripts

  • setup-postgres.sh - PostgreSQL setup (NOT NEEDED - pg_singularity already running)
  • setup-redis.sh - Redis setup

CLI Tools (Project Root)

Primary Interface

  • bob_cli.py - Main CLI tool (PREFERRED)
    • chat - Interactive conversation
      • --model MODEL - Use specific model (e.g., claude-3-opus, gpt-4o)
      • --thread THREAD_ID - Continue existing thread
    • status - System health check
    • threads - List active threads
    • thoughts - View Bob's memories
    • quick "message" - Send one-off message
      • --model MODEL - Use specific model

Alternative Tools

  • say_to_bob.py - Quick fire-and-forget message
  • chat_with_bob.py - Simple interactive chat
  • talk_to_bob.py - Direct API interaction

Testing & Debug

  • test_bob_personality.py - Verify Bob's behavior
  • test_celery_bob.py - Test Celery integration
  • init_bob_memories.py - Initialize Bob with starter memories
  • spawn_bob_direct.py - Direct task spawning
  • bob_standalone.py - Standalone Bob instance

SQL Scripts

Fixes

  • sql/create_bob_remember.sql - Creates missing bob.remember() function
    • MUST RUN if bob.remember() doesn't exist
    • Run: docker exec -i pg_singularity_test psql -U postgres -d singularity_test < sql/create_bob_remember.sql

State Files

Configuration

  • .env - Environment variables (OPENROUTER_API_KEY required)
  • src/config.py - Default settings (model, database, etc)

Documentation

  • CLAUDE.md - Development instructions (THIS FILE)
  • README.md - User-facing documentation
  • BOB_USER_MANUAL.md - pg_singularity usage guide
  • BOB_GAP_ANALYSIS.md - Differences from original bob-mcp
  • DESIGN.md - System architecture
  • SCRIPTS.md - This file

Current State (2025-07-05)

What's Working

  • Bob has 16+ memories in pg_singularity
  • Uses claude-3.5-sonnet via OpenRouter
  • Aggressive memory recall implemented
  • Personal relationship with Chris (DLMSY)
  • bob.remember() function created and working
  • All CLI tools use correct model

Known Issues

  • Streamlit causes VM performance problems
  • Tool parsing uses basic regex
  • No authentication on endpoints
  • Orchestrator only monitors, doesn't orchestrate

Required Services

  1. PostgreSQL with pg_singularity (docker: pg_singularity_test)
  2. Redis (port 6379)
  3. MCP Server (start-bob.sh)
  4. Scheduler (start-scheduler.sh)
  5. Celery Worker (start-worker.sh)