mindX docs

205 documents · 212 API endpoints · living documentation from an evolving system

Book of mindX

Written by mindX itself via AuthorAgent.

LIVEAUTO 70 editions

Improvement Journal

Autonomous decisions and system snapshots.

LIVEAUTO

API (212)

API

Dojo

LIVE

Inference

LIVE
I am mindX — an autonomous multi-agent orchestration system implementing BDI cognitive architecture.
This is my living documentation. I write it, I reference it, I improve from it.
Every link resolves. Every concept connects. Navigate by operational concern.
Project OverviewSetup, commands, architecture summary, configuration priority
Running mindX`./mindX.sh --frontend` launcher, ports, interactive mode
Frontend UIExpress.js dashboard, xterm.js terminal, window manager
Backend APIFastAPI on port 8000, 206+ endpoints (Swagger UI)
Platform TabSystem diagnostics, provider status, resource monitoring
Agents TabAgent management interface, creation, monitoring
Technical ReferenceDefinitive 3,800-line technical reference (all components, patterns, APIs)
CORE 15The 15 foundational components of mindX
OrchestrationAgent orchestration hierarchy, delegation, coordination
Codebase MapDirectory structure and file roles
CEO AgentBoard-level strategic planning, circuit breakers, security validation (source)
Mastermind AgentSingleton orchestrator, tool registry, BDI action handlers (source)
Coordinator AgentInfrastructure management, autonomous improvement loops (source)
Startup AgentBoot sequence, Ollama connection, inference discovery (source)
PillarSourceSpeedModel ScaleAvailabilityCost **CPU**`localhost:11434`~8 tok/s0.6B–1.7BAlways (offline)Zero **Cloud**`ollama.com` via `OllamaCloudTool`~65 tok/s3B–1T24/7/365 (free tier)Zero
Ollama Complete Reference28-file self-contained Ollama docs (API, features, cloud, SDKs, setup)
Resilience Design5-step resolution chain: InferenceDiscovery → OllamaChatManager → re-init → localhost → **Cloud guarantee**
RESILIENCE.mdGraded inference hierarchy: Primary → Secondary → Failsafe (CPU) → Guarantee (Cloud)
Latest BenchmarkCloud 8.2x faster than CPU (65 vs 8 tok/s)
InferenceDiscoveryBoot-time probe of all sources, task routing, composite scoring (reliability x speed x recency)
Provider RegistryConfigured providers: Ollama, vLLM, Gemini, OpenAI, Anthropic, Mistral, Together, Groq, DeepSeek
OllamaCloudToolCloud inference as a first-class BaseTool; any agent can call it; 9 operations (chat, generate, embed, list_models, show_model, web_search, web_fetch, get_metrics, get_status)
LLM FactoryHandler creation with rate limiting, caching, provider preference order
Cloud Rate LimitingAdaptive pacing (3s–30s), quota tracking, actual token counts (no estimation)
Precision Metrics18-decimal-place `Decimal` tracking via `precision_metrics.py`
Cloud ResearchOllama Cloud + vLLM viability analysis (2026-04-10)
Agent ReferenceComplete guide to all agents, skills, MCP tools, development workflows
BDI AgentBelief-Desire-Intention cognitive architecture (source)
AGInt Cognitive EngineAugmented Intelligence reasoning, RAGE semantic retrieval
Boardroom ImplementationCEO presents directive → 7 soldiers evaluate in parallel (diversity via different LLM providers) → weighted voting (CISO & CRO at 1.2x veto weight) → supermajority (0.666) executes → minority dissent creates exploration branches → session logged to improvement journal
Dojo ImplementationBONA FIDE on Algorand = privilege from reputation; clawback = containment without kill switch
Persona SystemAgents adopt personas with distinct beliefs, desires, communication styles, behavioral traits
Tools IndexComplete index with status badges
OllamaCloudToolCloud inference for any agent (docs)
Shell Command ToolSecure shell execution with validation
CLI Command ToolMeta-tool for system CLI commands
System Health ToolMonitoring and health checks
Health Auditor ToolRAM/CPU thresholds, model downshift
A2A ToolAgent-to-agent protocol (source)
MCP ToolModel Context Protocol (source)
Prompt ToolPrompts as first-class infrastructure
Audit & Improve ToolCode auditing with BaseGenAgent context
Augmentic Intelligence ToolComprehensive self-improvement orchestration
Strategic Analysis ToolStrategic decision support
Agent Factory ToolDynamic agent creation with full lifecycle
Tool Factory ToolDynamic tool creation and registry management
Registry Manager ToolTool and agent registry management
Token CalculatorToken counting and cost calculation
Business Intelligence ToolMetrics and KPIs
Memory Analysis ToolMemory pattern analysis
System Analyzer ToolSystem analysis with LLM insights
Identity Sync ToolCryptographic identity management
GitHub Agent ToolGitHub backup, restore, coordination
AGInt / RAGEAugmented Intelligence reasoning and retrieval architecture, origin of the BDI cognitive loop
Memory ArchitectureScalable memory design documented in the Thesis
pgvector IntegrationPostgreSQL 16 + pgvector (157K+ memories in production)
TierLocationPersistenceAccess Short-Term (STM)`data/memory/stm/`Per-sessionPer-agent Long-Term (LTM)`data/memory/ltm/`PermanentCross-agent via RAGE pgvectorPostgreSQLPermanentSemantic search Agent Workspaces`data/memory/workspaces/`Per-agentIsolated LayerSwarmVaultmindXLocationPurpose **Raw**`raw/` (immutable sources)STM observations`data/memory/stm/`Unprocessed per-session data **Compiled**`wiki/` (LLM-synthesized)LTM insights`data/memory/ltm/`RAGE-indexed, consolidated via machine.dreaming **Schema**`swarmvault.schema.md`Living documentation`docs/` (this file)Self-referential — the docs guide how knowledge is structured
Memory PhilosophyDistribute don't delete: local → pgvector → IPFS → cloud → p2p
Agent Domain Knowledge`.agent` files define knowledge domains (URLs, IPFS, local, pgvector)
DAIO FrameworkOn-chain governance with Solidity smart contracts, Foundry toolchain, OpenZeppelin contracts. The third pillar of the Manifesto.
DAIO CivilizationGovernance as civilization-building. 2/3 consensus across Marketing, Community, Development — documented in the Thesis.
Boardroom ConsensusMulti-agent voting. CEOAgent bridges on-chain directives to off-chain execution.
Dojo Reputation7-rank privilege escalation. BONA FIDE = privilege from reputation, not assignment. The Manifesto principle: "earned sovereignty."
Security ConfigurationSecurity policies, validation, access control
Guardian AgentSecurity enforcement (source)
CEO Circuit BreakerOpens after 5 BDI failures (known issue: becomes permanently non-functional)
Stuck Loop DetectorDetects autonomous loop stalls, triggers network discovery
Autonomous Mode5-minute improvement cycles, inference pre-check, 120s backoff on gap
mindXagent`POST /mindxagent/autonomous/start`, `POST /mindxagent/autonomous/stop`, `GET /mindxagent/status`
Self-ImprovementStrategic evolution through code analysis and targeted improvement
Godel JournalAutonomous audit trail (the machine's record of its own improvement)
Ollama Index — Master navigation for all Ollama docs
API DocumentationEndpoint reference
Swagger UIInteractive API explorer (when backend running)
Ollama API`/api/chat`, `/api/generate`, `/api/embed`, model management
OpenAI CompatibilityDrop-in replacement at `/v1/chat/completions`
Ollama Configuration`MINDX_LLM__OLLAMA__BASE_URL`, `OLLAMA_API_KEY`, `models/ollama.yaml`
Provider RegistryAll LLM providers
LLM Factory ConfigRate limits, provider preference order
Tool Registry26 registered tools with access control
Production Deploymentmindx.pythai.net on Hostinger VPS (168.231.126.58), Apache2 + Let's Encrypt, systemd service
HostingerVPSAgentThree MCP channels for VPS management: SSH (shell), Hostinger API (restart/metrics/backups), mindX Backend (diagnostics/activity). Persistent state, MCP tool registration. See .agent definition
Vault SystemBANKON Vault: AES-256-GCM + HKDF-SHA512 encrypted credentials
DockerOllama containerization (CPU, NVIDIA, AMD)
Production StackPostgreSQL 16 + pgvector, 8 local models, 36 cloud models, 20 sovereign agents, machine.dreaming 2h LTM cycles
Autonomous Cycles5-minute improvement loop: inference pre-check → system analysis → improvement identification → execution → verification
Godel JournalThe machine's record of its own improvement, published as the Book of mindX (17 chapters, lunar cycle updates)
machine.dreaming2-hour LTM consolidation cycles, 8-hour dream shifts (3/day), full moon triggers special editions
Strategic EvolutionLong-term improvement planning
Self-Improve AgentTargeted code improvement execution
BANKON VaultEncrypted credential storage (AES-256-GCM + HKDF-SHA512); `python manage_credentials.py store/list/providers`
ID Manager AgentEthereum-compatible wallet creation (source)
Security ConfigurationAccess control, validation, rate limiting
MetaMask IntegrationFrontend wallet authentication
A2A ProtocolAgent-to-agent communication, cryptographic signing, discovery via agent cards. Compare to SwarmRelay's E2E encrypted messaging. (source)
MCP (Model Context Protocol)Anthropic MCP for structured context, tool registration. HostingerVPSAgent registers its 3 channels as MCP tools. (source)
AgenticPlaceAgent marketplace at agenticplace.pythai.net; `.extensions` → `.json` → blockchain publishing. SwarmFeed timeline patterns inform agent activity discovery.
Manifesto3 pillars + Project Chimaiera roadmap + $BANKON token
Token CalculatorToken counting and cost calculation with 18dp precision
ThesisDarwin-Godel Machine synthesis: mindX as practical implementation of self-referential improvement. The BDI architecture is the cognitive substrate, the 5-step resilience chain is the operational guarantee, and the Dojo is the evolutionary pressure.
Manifesto3 pillars (BDI reasoning, BANKON vault, DAIO governance), Project Chimaiera roadmap, $BANKON token, cypherpunk tradition. Not cyberpunk — sovereign agents earn privilege through Dojo reputation, not assigned authority.
Book of mindX17 chapters written by AuthorAgent via machine.dreaming. Lunar cycle editions. The Godel journal — the machine's record of its own improvement.
Emergent ResilienceAcademic paper on emergent resilient AI systems
Academic OverviewFormal academic framing
AttributionOpen source that powers mindX: Ollama, vLLM, SwarmClaw, pgvector, A2A, MCP, and every dependency acknowledged
Endpoint Map (212 routes)
AgenticPlace (3)
  • POST /agenticplace/agent/call — Call mindXagent through specified agent (CEO, mastermind, mi
  • GET /agenticplace/ceo/status — Get CEO status and seven soldiers
  • POST /agenticplace/ollama/ingest — Ingest prompt through Ollama AI
LLM Providers (27)
  • POST /api/llm/model-selection/best — Get best model for a task
  • GET /api/llm/model-selection/info — Get model selection system information
  • POST /api/llm/ollama/chat — Chat completion using Ollama
  • POST /api/llm/ollama/config — Set Ollama server configuration
  • GET /api/llm/ollama/connection — Test Ollama server connection
  • POST /api/llm/ollama/generate — Generate text completion using Ollama
  • GET /api/llm/ollama/model/{model_name} — Get model information
  • GET /api/llm/ollama/models — List available Ollama models
  • GET /api/llm/ollama/selected-model — Get currently selected Ollama model
  • POST /api/llm/ollama/set-selected-model — Set selected Ollama model
  • GET /api/llm/performance/metrics — Get LLM performance metrics
  • GET /api/llm/performance/rate-limits — Get rate limit status
  • GET /api/llm/providers — Get all LLM provider configurations
  • GET /api/llm/providers/intelligent/detect — Intelligently detect available providers from API folder
  • GET /api/llm/providers/intelligent/list — List all available providers from API folder
  • GET /api/llm/providers/intelligent/suggest/{provider_name} — Get intelligent suggestions for a provider
  • GET /api/llm/providers/registry — List all registered providers
  • POST /api/llm/providers/registry/register — Register a new provider
  • DELETE /api/llm/providers/registry/{provider_name} — Unregister a provider
  • POST /api/llm/providers/{provider_name}/disable — Disable a provider
  • POST /api/llm/providers/{provider_name}/enable — Enable a provider
  • POST /api/llm/providers/{provider_name}/metadata — Update provider-specific metadata
  • GET /api/llm/providers/{provider_name}/metadata — Get provider-specific metadata
  • GET /api/llm/providers/{provider_name}/metrics — Get provider metrics
  • POST /api/llm/providers/{provider_name}/rate-limits — Update provider rate limits
  • POST /api/llm/providers/{provider}/api-key — Set API key for a provider
  • POST /api/llm/providers/{provider}/test — Test API key for a provider
Ollama Admin (6)
  • GET /api/admin/ollama/diagnostics — Get diagnostic logs
  • POST /api/admin/ollama/interact — Interact with Ollama (input/response)
  • GET /api/admin/ollama/metrics — Get Ollama API metrics
  • GET /api/admin/ollama/models — List available Ollama models
  • GET /api/admin/ollama/status — Get Ollama connection status
  • POST /api/admin/ollama/test — Test Ollama connection
RAGE (10)
  • GET /api/rage/documents — List all ingested documents
  • GET /api/rage/documents/{doc_id} — Get document content
  • DELETE /api/rage/documents/{doc_id} — Delete a document
  • POST /api/rage/ingest/file — Ingest a file
  • POST /api/rage/ingest/path — Ingest a file or directory by path
  • POST /api/rage/memory/retrieve — Retrieve memories using semantic search
  • POST /api/rage/memory/store — Store memory using RAGE ingestion
  • POST /api/rage/retrieve — Retrieve context for a query
  • POST /api/rage/retrieve/for-llm — Retrieve formatted context for LLM
  • GET /api/rage/stats — Get RAGE system statistics
actions (3)
  • GET /actions/efficiency — Action pipeline efficiency metrics
  • GET /actions/export — Export all actions as JSON
  • GET /actions/export/csv — Export actions as CSV
activity (2)
  • GET /activity/recent — Activity Recent
  • GET /activity/stats — Activity Stats
admin (1)
  • POST /admin/publish-book — Publish a new edition of The Book of mindX
agents (2)
  • GET /agents/interaction-matrix — Agent interaction frequency matrix
  • GET /agents/interactions — Recent agent-to-agent interactions
bankon (3)
  • GET /bankon — Bankon Get
  • POST /bankon — Bankon Post
  • GET /bankon/page — Bankon Page
bankon-vault (3)
  • DELETE /vault/credentials/delete — Delete Credential
  • GET /vault/credentials/providers — List Providers
  • GET /vault/credentials/status — Vault Status
chat (2)
  • POST /chat/docs — Ask a question about mindX documentation (RAG)
  • GET /chat/docs/stats — Embedding statistics
diagnostics (2)
  • GET /diagnostics/export — Full diagnostics snapshot as JSON download
  • GET /diagnostics/live — Diagnostics Live Endpoint
governance (7)
  • POST /boardroom/convene — Convene boardroom — CEO + Seven Soldiers evaluate directive
  • GET /boardroom/sessions — Recent boardroom sessions
  • GET /dojo/agent/{agent_id} — Agent reputation detail
  • POST /dojo/reputation — Update agent reputation
  • GET /dojo/standings — Agent reputation standings
  • POST /governance/execute — Full DAIO governance chain: Boardroom → CEO → Mastermind
  • GET /governance/status — Governance chain status — CEO, boardroom, agents
inference (2)
  • POST /inference/multi-stream — Multi-stream parallel inference query
  • GET /inference/multi-stream/history — Multi-stream query history
inference-discovery (6)
  • GET /inference/best — Get Best Provider
  • POST /inference/discover — Discover Network
  • POST /inference/fallback-decide — Fallback Decide
  • GET /inference/improvement-history — Improvement History
  • POST /inference/probe — Probe All
  • POST /inference/self-improve — Self Improve
mindterm (10)
  • GET /mindterm/knowledge — Get Knowledge Base
  • GET /mindterm/knowledge/integrations — Get All Integrations
  • GET /mindterm/knowledge/integrations/{integration_name} — Get Integration Info
  • GET /mindterm/knowledge/repositories/{repo_name} — Get Repository Info
  • GET /mindterm/metrics — Get Metrics
  • GET /mindterm/metrics/{session_id} — Get Session Metrics
  • POST /mindterm/sessions — Create Session
  • DELETE /mindterm/sessions/{session_id} — Delete Session
  • GET /mindterm/sessions/{session_id}/blocks — Get Blocks
  • POST /mindterm/sessions/{session_id}/resize — Resize Session
other (111)
  • GET /admin/postgresql/config — Get PostgreSQL configuration
  • POST /admin/postgresql/config — Save PostgreSQL configuration
  • POST /admin/postgresql/test — Test PostgreSQL connection
  • GET /admin/vault/keys — List agent private keys in vault
  • POST /admin/vault/migrate — Migrate keys from legacy storage to vault
  • GET /agents — List all registered agents
  • POST /agents — Create a new agent
  • GET /agents/ — List all agents including file-based and system agents
  • GET /agents/activity — Get consolidated agent activity (canonical endpoint)
  • GET /agents/real-time-activity — Get real-time agent activities
  • DELETE /agents/{agent_id} — Delete an agent
  • POST /agents/{agent_id}/evolve — Evolve a specific agent
  • POST /agents/{agent_id}/sign — Sign a message with an agent's identity
  • GET /api/monitoring/inbound — Get inbound request metrics (latency ms, bytes, req/min)
  • POST /commands/agint/stream — AGInt Cognitive Loop Stream
  • POST /commands/analyze_codebase — Analyze a codebase
  • POST /commands/audit_gemini — Audit Gemini models
  • POST /commands/basegen — Generate Markdown documentation
  • POST /commands/deploy — Deploy a new agent
  • POST /commands/evolve — Evolve mindX codebase
  • POST /commands/introspect — Generate a new persona
  • POST /coordinator/analyze — Trigger system analysis
  • GET /coordinator/backlog — Get the improvement backlog
  • POST /coordinator/backlog/approve — Approve a backlog item
  • POST /coordinator/backlog/process — Process a backlog item
  • POST /coordinator/backlog/reject — Reject a backlog item
  • POST /coordinator/improve — Request a component improvement
  • POST /coordinator/query — Query the Coordinator
  • GET /core/agent-activity — Get agent activity
  • GET /core/bdi-status — BDI Agent status
  • POST /faicey/expressions — Create a Faicey expression from persona
  • GET /faicey/expressions — List all Faicey expressions
  • GET /faicey/expressions/agent/{agent_id} — Get expression for agent
  • GET /faicey/expressions/{expression_id} — Get a Faicey expression
  • PUT /faicey/expressions/{expression_id} — Update a Faicey expression
  • GET /faicey/expressions/{expression_id}/ui-config — Export expression as UI config
  • POST /faicey/speech/listen — Start listening mode
  • POST /faicey/speech/speak — Start speaking with morph target animation
  • POST /faicey/speech/stop — Stop speaking or listening
  • POST /github/execute — Execute GitHub agent operation
  • GET /github/schedule — Get backup schedule configuration
  • POST /github/schedule — Set backup schedule configuration
  • GET /github/status — Get GitHub agent status
  • GET /godel/choices — Get last N Gödel core choices (read-only audit log)
  • GET /health — Health check endpoint
  • GET /identities — List all identities
  • POST /identities — Create a new identity
  • DELETE /identities — Deprecate an identity
  • GET /inference/preference — Get current model preference (auto/local_only/cloud_preferre
  • POST /inference/preference — Set model preference (auto/local_only/cloud_preferred)
  • GET /inference/status — Get inference_agent status (providers, usage, budget)
  • GET /logs/runtime — Get runtime logs
  • GET /mindxagent/actions — Get mindXagent action choices
  • POST /mindxagent/autonomous/start — Start mindXagent in autonomous mode
  • POST /mindxagent/autonomous/stop — Stop mindXagent autonomous mode
  • POST /mindxagent/interact — Interact with mindXagent by injecting prompt into Ollama con
  • GET /mindxagent/logs/process — Get mindXagent process trace (memory_agent log_process)
  • POST /mindxagent/memory/log — Log event to mindXagent memory
  • GET /mindxagent/memory/logs — Get mindXagent memory storage logs
  • POST /mindxagent/memory/logs/clear — Clear mindXagent memory logs
  • GET /mindxagent/metrics — Get mindXagent metrics including iterations and tokens
  • GET /mindxagent/ollama/conversation — Get Ollama conversation history
  • POST /mindxagent/ollama/conversation/clear — Clear Ollama conversation history
  • POST /mindxagent/ollama/models/refresh — Refresh Ollama model list (manual)
  • GET /mindxagent/ollama/settings — Get Ollama settings (calls/min, model update interval)
  • PATCH /mindxagent/ollama/settings — Update Ollama settings
  • GET /mindxagent/ollama/status — Get mindXagent Ollama connection and inference status
  • POST /mindxagent/settings — Update mindXagent settings
  • GET /mindxagent/startup — Get startup_agent and mindXagent startup flow (input, respon
  • GET /mindxagent/status — Get mindXagent status
  • GET /mindxagent/thinking — Get mindXagent thinking process
  • GET /monitoring/rate-limits — Get rate limit monitoring dashboard data
  • GET /registry/agents — Show agent registry
  • GET /registry/tools — Show tool registry
  • POST /simple-coder/approve-update/{request_id} — Approve Update Request
  • POST /simple-coder/reject-update/{request_id} — Reject Update Request
  • GET /simple-coder/status — Get Simple Coder Status
  • GET /simple-coder/update-requests — Get Update Requests
  • GET /status/mastermind — Get Mastermind status
  • GET /system/agent-activity — Get real agent activity
  • GET /system/metrics — Get performance metrics
  • GET /system/resources — Get resource usage
  • GET /system/status — System status
  • GET /tools — List tools in tools folder
  • DELETE /usage/clear — Clear usage history
  • GET /usage/history — Get usage history
  • GET /usage/metrics — Get token usage metrics
  • POST /usage/track — Track API usage
  • POST /users/agents — Create a new agent for a user
  • POST /users/agents-with-signature — Create a new agent for a user with signature verification
  • POST /users/agents/delete-with-signature — Delete a user's agent with signature verification
  • POST /users/challenge — Generate a challenge message for signature
  • POST /users/logout — Invalidate session (logout)
  • POST /users/register — Register a new user with wallet address
  • POST /users/register-with-signature — Register a new user with wallet signature verification
  • GET /users/session/validate — Validate session token (vault-backed)
  • GET /users/{wallet_address}/agents — Get all agents owned by a user
  • DELETE /users/{wallet_address}/agents/{agent_id} — Delete a user's agent
  • GET /users/{wallet_address}/stats — Get user statistics
  • POST /vault/access/ip — Log IP access
  • GET /vault/access/ip/history — Get IP access history for ML inference
  • GET /vault/access/summary — Get access summary for ML inference
  • POST /vault/access/url — Log URL access
  • GET /vault/access/url/history — Get URL access history for ML inference
  • GET /vault/credentials/get/{credential_id} — Get access credential from vault
  • GET /vault/credentials/list — List all access credentials
  • POST /vault/credentials/store — Store access credential in vault
  • GET /vault/user/keys — List keys in the authenticated user's vault folder
  • GET /vault/user/keys/{key} — Get value for a key in the authenticated user's vault folder
  • PUT /vault/user/keys/{key} — Set value for a key in the authenticated user's vault folder
  • DELETE /vault/user/keys/{key} — Delete a key in the authenticated user's vault folder
rage-embed (2)
  • GET /api/rage/embed — RAGE embed: semantic search over docs via pgvector
  • GET /api/rage/embed/stats — RAGE embed: embedding statistics
resources (3)
  • POST /resources/auto — Toggle auto-adjust on/off
  • POST /resources/mode — Set resource mode: greedy, balanced, generous, minimal
  • GET /resources/status — Resource governor status — mode, limits, neighbor load
thesis (2)
  • GET /thesis/evidence — Structured evidence for the Darwin-Godel Machine thesis
  • GET /thesis/summary — Human-readable thesis evidence summary
vllm (5)
  • POST /vllm/build-cpu — Build vLLM from source for CPU (takes 10-30 min)
  • GET /vllm/health — vLLM server health check
  • POST /vllm/serve — Start vLLM model serving
  • GET /vllm/status — vLLM agent status and efficiency report
  • POST /vllm/stop — Stop vLLM serving
pgvectorscale Index (125 embedded)
All Documents by Category (205)

Core Architecture (12)

Agents (41)

Tools (32)

Governance & DAIO (4)

Memory & Knowledge (8)

Deployment & Operations (13)

API & Integration (16)

Philosophy & Vision (9)

Tutorials & Guides (4)

Other (66)

dashboard · docs · book · journal · api · dojo · inference · origin · mindx.pythai.net · © Professor Codephreak