PALabs LogoPALABS
DownloadPlaygroundDocsResearchShowcaseBenchmarksComparisonChangelogAbout
GET STARTED
DownloadPlaygroundDocsResearchShowcaseBenchmarksComparisonChangelogAbout
GET STARTED
Getting Started
  • Installation & Prerequisites
    System requirements, Docker setup, and one-command start.sh launcher.
  • Quickstart Guide
    Describe your friend in natural prose, record voice, and talk.
  • Configuration Reference
    Complete .env parameters, launch flags, and compose profiles.
  • Docker Compose Guide
    Multi-container orchestration, port mappings, and volume persistence.
Brain: Cognitive Architecture
  • Architecture of Mind
    The 7-stage cognitive turn and the BDI loop underneath it, from perception to closure.
  • Endocrine & Affect System
    Tonic/phasic cortisol, dopamine, and adrenaline; Marsh trust and Bowlby attachment; LLM sampling modulation.
  • Memory & Learned Lexicon
    ACT-R power-law decay, Neo4j knowledge graphs, and subconscious REM reflection.
  • 3-Tier Persona Constitution
    Immutable safety core, constitutional temperament, and adaptive trait evolution.
  • Theory of Mind & Metacognition
    Tracking what the user knows and believes, and calibrated confidence that gates when the agent hedges or abstains.
Mesh & Systems Architecture
  • Mesh Architecture
    9-agent decoupled signal-bus coordinated over NATS JetStream.
  • Privacy & Data Sovereignty
    Local-first isolation, zero external data egress, and hardware confinement.
Voice & Vision: Supporting Modalities
  • Speech & Voice Pipeline
    Dual-path whisper.cpp/SenseVoice STT, GPT-SoVITS 32kHz, and barge-in mechanics.
  • Visual Appraisal System
    Moondream VLM screen and camera observer with habituation dampening. Opt-in and secondary to the Brain.
API & Protocol Specifications
  • REST API Endpoints
    FastAPI REST surface for persona compilation, voice, and memory.
  • WebSocket Streaming Protocol
    Real-time /api/chat/ws protocol, turn_id correlation, and event schemas.
  • NATS Topics & Contracts
    Pydantic contract schemas and JetStream subject routing table.
Developer & Operations Guides
  • Voice Training on GPU
    GPT-SoVITS fine-tuning on Google Colab or local NVIDIA hardware.
  • Colab GPU Acceleration
    Remote training, SSH tunnels, and VS Code Remote integration.
  • Disaster Recovery & Backup
    Atomic 4-store friend archive export, import, and cross-machine migration.
  • Cloud LLM Fallback
    Anthropic Claude API integration with endocrine parameter translation.
  • Custom Agents & Plugins
    Extending the NATS mesh with custom Python or Rust worker agents.
Testing & Quality Assurance
  • Evaluation Harness
    Running single-turn and multi-turn probe suites and recall@k benchmarks.
  • Code Quality & Static Analysis
    mypy typing, radon cyclomatic complexity, and bandit security gates.
  • Mutation Testing Discipline
    Targeted mutation testing with mutmut to prevent mock leakage.
Troubleshooting
  • Common Issues & Playbooks
    Resolving port conflicts, container health checks, and audio device errors.
  • Hardware Tuning & Optimization
    RAM management, CPU thread tuning, and VLM residency optimization.
Documentation

PALabs Docs

Everything here lives in this repo and is checked against the actual code, not a separate docs project that can drift from it.

Getting Started

One-command install and the four commands that get you talking to your friend.

  • Installation & Prerequisites
  • Quickstart Guide
  • Configuration Reference
  • Docker Compose Guide

Brain: Cognitive Architecture

  • Architecture of Mind
  • Endocrine & Affect System
  • Memory & Learned Lexicon
  • 3-Tier Persona Constitution
  • Theory of Mind & Metacognition

Mesh & Systems Architecture

  • Mesh Architecture
  • Privacy & Data Sovereignty

Voice & Vision: Supporting Modalities

  • Speech & Voice Pipeline
  • Visual Appraisal System

API & Protocol Specifications

  • REST API Endpoints
  • WebSocket Streaming Protocol
  • NATS Topics & Contracts

Developer & Operations Guides

  • Voice Training on GPU
  • Colab GPU Acceleration
  • Disaster Recovery & Backup
  • Cloud LLM Fallback
  • Custom Agents & Plugins

Testing & Quality Assurance

  • Evaluation Harness
  • Code Quality & Static Analysis
  • Mutation Testing Discipline

Troubleshooting

Real gotchas from real runs, not a generic FAQ.

  • Common Issues & Playbooks
  • Hardware Tuning & Optimization