INDEX.md · 43.4 KB
MindX Documentation Index
Comprehensive Documentation Index
This document provides a complete index of all documentation in the mindX system, organized by category and component type.
Last Updated: 2026-04-03
Total Documentation Files: 194+
CORE Documentation: Complete 15-component analysis ✅
Agent Documentation: 34+
Tool Documentation: 29+
DAIO Documentation: 15 files covering 12 core + modular contracts ✅
Production Ready: ✅ Enterprise-grade deployment and security documentation complete
🌐 mindX API (read the docs)
mindX provides an API for agents, UIs, and external systems. When the backend is running (default port 8000):
Interactive docs (Swagger UI): http://localhost:8000/docs
API reference: API.md — base URL, route groups, AgenticPlace connection, connecting mindX to Ollama
AgenticPlace uses mindX as its provider; see AgenticPlace_Deep_Dive.md and API.md.
📊 Monitoring and Rate Control (both directions)
Whether mindX is ingesting, providing inference, or services, monitoring and rate control are essential in both directions (inbound and outbound). Actual network and data metrics are in scientific units (ms, bytes, req/min).
Doc: monitoring_rate_control.md — bidirectional monitoring, scientific metrics (latency ms, payload bytes, throughput req/s and req/min), where they are collected (inbound middleware, outbound limiters, PerformanceMonitor)
Inbound API: GET /api/monitoring/inbound — inbound request metrics (latency_ms, request/response bytes, requests_per_minute, rate_limit_rejects)
Outbound: llm/rate_limiter.py, api/ollama/ollama_url.py and other provider APIs expose get_metrics(); see rate_limiting_optimization.md
🏛️ mindX + DAIO Integration
mindX is enhanced with DAIO (Decentralized Autonomous Intelligence Organization) - a comprehensive blockchain-native governance and economic layer that enables autonomous agent coordination with cryptographic sovereignty.
Complete Integration: DAIO Documentation Index - 15 documentation files covering 12 smart contracts
Governance Model: Hybrid human-AI consensus (66.67% human + 33.33% AI weighted voting)
Economic Framework: Multi-project treasury with 15% diversification and tithe
Agent Identity: IDNFT and SoulBadger systems for cryptographic agent identity
Constitutional Enforcement: Immutable governance rules via smart contracts
Key DAIO Integration Points:
IDManagerAgent enhanced with IDNFT blockchain identity
Governance participation via knowledge-weighted AI agent voting
Treasury integration for autonomous funding and economic operations
Constitutional enforcement for governance rule compliance
📚 Documentation Categories
🤖 Agent Documentation
All agent documentation is organized in the agents/ folder structure. See agents/index.md for the complete agent registry.
🧠 CORE System Documentation (15 Foundational Components)
Primary CORE References:
CORE.md - ✅ COMPLETE CORE ARCHITECTURE - Definitive technical reference for all 15 CORE components
CORE_AUDIT_SUMMARY.md - Complete audit results and CORE analysis summary
ORCHESTRATION.md - Updated with accurate CORE startup sequence and dependencies
AGENTS.md - Complete agent registry with CORE vs Specialized classification
CORE Component Documentation:
Meta-Orchestration:
MindXAgent (agents/core/mindXagent.py) - Meta-orchestrator with complete system understanding (~149KB)
Cognitive Architecture:
BDI Agent - Core reasoning engine with Belief-Desire-Intention architecture (~64KB)
AGInt Agent - P-O-D-A cognitive loop orchestrator (~32KB)
Belief System - Singleton shared knowledge store with confidence scoring (~8KB)
ReasoningAgent - Deductive/inductive reasoning engine
Infrastructure Services:
CoordinatorAgent - Central service bus with pub/sub system (~56KB)
MemoryAgent - Persistent memory with STM/LTM promotion (~53KB)
ID Manager Agent - Cryptographic identity ledger (~16KB)
GuardianAgent - Security infrastructure and access control (~16KB)
SessionManager - Session lifecycle management
Orchestration Layer:
MastermindAgent - Strategic control and AION directive management (~41KB)
StartupAgent - System bootstrap controller (~83KB)
SystemStateTracker - State management and event tracking
Total CORE: ~582KB of foundational code enabling all system functionality
Agent Implementations (agents/)
Guardian Agent - Security backbone with identity validation and access control
Memory Agent - Infrastructure layer for persistent memory
AutoMINDX Agent - Persona manager with iNFT export and marketplace integration
Persona Agent - Persona adoption and management with BDI integration
Avatar Agent - Avatar generation for agents and participants
Coral ID Agent - CrossMint-integrated identity management with multi-chain support
Enhanced Simple Coder - Advanced coding agent with multi-model intelligence
Simple Coder Agent - BDI-integrated coding assistant with unified sandbox (Complete reference documentation)
Simple Coder - Enhanced coding agent with sandbox and autonomous mode
SimpleCoder Memory Integration - Comprehensive memory integration with update requests stored in simple_coder_sandbox/update_requests.json
Simple Coder Agent Sandbox Fix - Sandbox integration fix and verification
Simple Coder Sandbox Analysis - Analysis of sandbox system and patterns
Test Results: mindX with Simple Coder - Integration test results and memory logs
Dynamic Agents (agents/)
Analyzer Agent - Dynamic code analysis agent
Benchmark Agent - Performance benchmarking agent
Checker Agent - Quality assurance agent
Processor Agent - Data processing agent
Reporter Agent - Test reporting agent
Validator Agent - Test data validation and integrity verification
Evolution Components (agents/evolution/)
Blueprint Agent - Strategic planning agent generating blueprints for self-improvement iterations
Blueprint to Action Converter - Converts strategic blueprints into executable BDI actions
Blueprint: mindX Framework - Gödel Machine–inspired blueprint: blockchain + PGVectorScale for THOTs (Higher Order Thoughts) and thlnks (links); directive for building mindX as self-referential, attestable memory system
Directives - Canonical mindX directives (e.g. Blueprint directive) for evolve/strategic commands
Learning Components (agents/learning/)
Strategic Evolution Agent - Comprehensive campaign orchestrator with audit-driven self-improvement pipeline
Goal Management System - Comprehensive goal management with priority queue and dependency tracking
Plan Management System - Multi-step plan management with action execution and dependency tracking
Self Improvement Agent - Self-modifying agent for code analysis, implementation, and evaluation
Monitoring Components (agents/monitoring/)
Performance Monitor - Singleton performance monitoring system tracking LLM call metrics
Resource Monitor - Comprehensive real-time system resource monitoring
Error Recovery Coordinator - Centralized error recovery coordinator for system-wide reliability
Monitoring Integration - Unified monitoring integration layer coordinating all monitoring components
Token Calculator Tool - Production-grade token cost calculation and usage tracking
Orchestration Components (agents/orchestration/)
Coordinator Agent - Central kernel and service bus orchestrating all system interactions
Mastermind Agent - Strategic intelligence layer orchestrating high-level objectives and campaigns
CEO Agent - Highest-level strategic executive coordinator with business planning
Startup Agent - Controls agent startup and initialization; the backend startup process connects to Ollama and initializes the StartupAgent (via Mastermind lifecycle) to drive mindXagent startup flow
Autonomous Audit Coordinator - Autonomous audit coordinator scheduling systematic audit campaigns
Complete Agent Registry: See agents/index.md for full details, NFT metadata, and registry information.
🛠️ Tool Documentation
All tool documentation is organized in the tools/ folder. Tools are now organized into subfolders for better structure and expansion. See TOOLS_INDEX.md for the complete tool registry and tools_organization_audit.md for the organization audit.
Core Tools (tools/core/)
CLI Command Tool - Command-line interface execution tool
Shell Command Tool - Shell command execution with security and validation
System Health Tool - System health monitoring and diagnostics (CFO Priority Access ✅)
Financial Tools (tools/financial/) - CFO Priority Access
Business Intelligence Tool (v2.0) - Business intelligence and analytics with CFO priority access. Integrates with system_health_tool and token_calculator_tool for comprehensive metrics.
Token Calculator Tool (Robust) - Enhanced token counting and cost calculation (CFO Priority Access ✅)
Registry & Factory Tools (tools/registry/)
Registry Manager Tool - Registry management and synchronization
Registry Sync Tool - Registry synchronization and consistency
Tool Registry Manager - Tool registry management
Agent Factory Tool - Dynamic agent creation and management
Tool Factory Tool - Dynamic tool creation and management
Communication Tools (tools/communication/)
Prompt Tool - Prompt management as infrastructure. Distinction: agent.persona defines behavioral traits, agent.prompt defines specific instructions.
A2A Tool - Agent-to-Agent communication protocol
MCP Tool - Model Context Protocol support
Monitoring Tools (tools/monitoring/)
System Analyzer Tool - Comprehensive system analysis
Memory Analysis Tool - Memory system analysis and optimization
Development Tools (tools/development/)
Audit and Improve Tool - Code audit and improvement automation
Augmentic Intelligence Tool - Augmentic intelligence and registry management
Strategic Analysis Tool - Strategic analysis and planning
Summarization Tool - Text summarization and analysis
Note Taking Tool - Note taking and documentation
Identity Management Tools (tools/identity/)
Identity Sync Tool - Comprehensive identity synchronization and management for agents and tools
Specialized Tools (tools/ root)
Web Search Tool - Web search and information retrieval
Tree Agent - Directory structure analysis and visualization
GitHub Agent Tool - GitHub backup and version control automation
LLM Tool Manager - LLM tool management and coordination
User Persistence Manager - User persistence and state management
Optimized Audit Gen Agent - Optimized audit generation
Ollama Model Capability Tool - Ollama model capability storage and intelligent model selection for task-specific optimization. Automatically discovers models, registers capabilities, and selects the best model for each task type (code generation, reasoning, chat, etc.). Located in api/ollama/ollama_model_capability_tool.py
Ollama Chat Display Tool - Manages and displays Ollama chat conversations for mindXagent. Provides real-time conversation history, message formatting for UI display, conversation clearing, and display status monitoring. Integrates with mindXagent's Ollama chat manager. Located in api/ollama/ollama_chat_display_tool.py
Specialized Tools
GitHub Agent Tool - GitHub backup and version control automation with integrated UI controls for backup operations, schedule management, and repository access. The tool provides real-time status monitoring, backup creation, and synchronization capabilities through the mindX frontend interface. See GitHub Agent Documentation for complete details on operations, integration, and UI features.
Complete Tool Registry: See TOOLS_INDEX.md for full details and usage information.
Tools Organization: See tools_organization_audit.md for comprehensive audit, organization structure, CFO priority access implementation, and production readiness checklist.
📖 System Documentation
Production Deployment & Operations
Production Deployment Guide - ✅ PRODUCTION READY Complete VPS deployment guide with automated scripts, security hardening, and monitoring setup
Security Configuration Guide - ✅ ENTERPRISE SECURITY Comprehensive security setup: encrypted vault, authentication, rate limiting, network security, and monitoring
API Documentation - ✅ COMPLETE API REFERENCE Full API documentation with endpoints, authentication, examples, and SDK usage patterns
Architecture & Design
Academic Overview - ✅ PhD-LEVEL ANALYSIS Comprehensive academic overview of mindX contributions to autonomous AI field, theoretical foundations, and technical workflows
System Architecture Map - Complete system architecture overview
Agents Architectural Reference - Agent architecture patterns and design
Design Documentation - System design principles and patterns
Codebase Map - Codebase structure and organization
Core Systems
BDI Agent - Belief-Desire-Intention cognitive architecture
Belief System - Belief management and confidence scoring
Memory System - Memory architecture and persistence
pgvectorscale Memory Integration - Semantic memory with vector similarity search
Vault System - ✅ PRODUCTION ENCRYPTED VAULT AES-256 encrypted credential storage with PBKDF2 key derivation, secure wallet private key management, URL/IP access tracking, vault-backed user sessions (wallet auth), per-wallet user folders (signature-scoped), and frontend vault_manager.js. Optional access gate (NFT/fungible) for session issuance; see LIT_AND_ACCESS_ISSUANCE. DAIO keyminter contracts (VaultKeyDynamic, VaultKeyIntelligent) mint vault access keys.
Identity Management - Identity and authentication systems
Orchestration - System orchestration and coordination
System Architecture Map - Complete system architecture overview and component organization
🏛️ DAIO: Decentralized Autonomous Intelligence Organization
Complete blockchain-native governance and economic layer for autonomous agent coordination
Primary DAIO Documentation:
DAIO.md - ✅ COMPLETE DAIO OVERVIEW - Comprehensive blockchain integration strategy with governance model
DAIO Civilization Governance - Advanced governance framework and civilization-scale coordination
DAIO Documentation Index - ✅ COMPLETE DAIO DOCS - Comprehensive index of all 15 DAIO documentation files
DAIO Core Contracts (12 Foundational + Modular Extensions):
Core Governance Contracts (4):
DAIOGovernance - Main governance orchestrator hub
KnowledgeHierarchyDAIO - AI-weighted voting (66.67% human + 33.33% AI)
DAIOTimelock - Delayed execution controller with security
DAIO_Constitution - Constitutional rules enforcement
Identity & Agent Management (3):
IDNFT - Agent identity NFTs with comprehensive metadata
SoulBadger - Soulbound credentials (ERC-5484)
AgentFactory - Agent creation with tokens/NFTs
Economic Infrastructure (3):
Treasury - Multi-project treasury with 15% diversification mandate
DAIORebaseToken - Primary DAIO token with rebase mechanics
GovernanceSettings - Configuration management
Voting & Extensions (2):
FractionalNFT - Fractionalized NFT voting integration
BoardroomExtension - Extended governance and treasury features
13th+ Contract - Consensys-Driven Service Branching:
Modular Expansion Framework - DAIO branches into specialized services (Branch, Boardroom, Dojo, Citadel)
Service Branching Architecture - Consensys-driven expansion via knowledge-weighted voting
DAIO Integration Guides:
DAIO-mindX Integration - Comprehensive integration guide for DAIO with mindX platform
DAIO Interaction Diagrams - Visual architecture and flow diagrams
DAIO Ecosystem - Complete ecosystem mapping and external references
ARC Protocol Integration (5 contracts):
DatasetRegistry - Decentralized dataset registry for AI training
ProviderRegistry - Provider network management
PinDealEscrow - Escrow mechanism for dataset transactions
ChallengeManager - Dispute resolution system
RetrievalReceiptSettler - Transaction settlement layer
Key DAIO Features:
Hybrid Governance: 66.67% human + 33.33% AI weighted voting
15% Diversification: Maximum allocation enforcement
15% Treasury Tithe: Automatic on all deposits
Knowledge-Weighted Voting: AI agents vote based on expertise level
Soulbound Identity: Permanent credential binding
Constitutional Enforcement: Immutable rules via smart contracts
Monitoring & Performance
Monitoring and Rate Control (both directions) - Bidirectional monitoring and rate control (inbound/outbound); actual network and data metrics in scientific units (ms, bytes, req/min); ingestion, inference, and services
Performance Monitor - Performance monitoring and metrics
Resource Monitor - Resource monitoring and alerts
Rate Limiting & Optimization - Rate limit profiles, provider YAML, quota distribution, API references
Enhanced Monitoring System - Enhanced monitoring capabilities
Monitoring Implementation Summary - Monitoring implementation details
Evolution & Learning
Strategic Evolution Agent - Strategic evolution and self-improvement
Autonomous Improvements Implementation - Autonomous improvement system
Audit Driven Campaign Implementation - Audit-driven campaign system
MindX Evolution Startup Guide - Evolution system startup guide
📘 Guides & Tutorials
Getting Started
README - Main project documentation
INSTALL - Installation and deployment (use with mindX.sh for one-command setup and service management)
Usage Guide - Usage instructions and examples
Technical Documentation - Technical specifications
Instructions - Setup and configuration instructions
Simple Coder Integration Guide - Complete guide for using Simple Coder system
Integration Guides
Lit Protocol and Access Issuance - Wallet signature as identity; optional NFT/fungible gate for session issuance; mapping to Lit Protocol social login and ACCs
Token Calculator Integration Guide - Token calculator integration
CEO Agent Battle Hardened Guide - CEO agent production guide
MindTerm Integration - MindTerm integration guide
Operational Guides
MindX.sh Quick Reference - Quick reference for mindX.sh
MindX.sh Documentation - Complete mindX.sh documentation
Run MindX Coordinator - Coordinator execution guide
User Interface
MindX Frontend - Web interface documentation
Platform Tab - Enterprise platform dashboard
Agents Tab - Agent management and AGIVITY monitoring
Workflow Tab - Agent interaction visualization
🔬 Analysis & Reports
System Analysis
Frontend Backend Analysis - Frontend/backend architecture analysis
MindX Internal Workflow Analysis - Internal workflow analysis
Memory System Replacement Audit - Memory system audit
Memory Storage and Data Folder Log Review - Comprehensive review of memory_agent storage architecture, data folder organization, and log system patterns
Orchestration Audit - Orchestration system audit
Implementation Reports
Tools Audit Summary - Tools audit and improvements
Orchestration Improvements Summary - Orchestration improvements
Memory Logging Improvements Summary - Memory logging improvements
Real Pricing Implementation Summary - Pricing implementation
🎯 Strategic & Business
Strategic Planning
Monetization Blueprint - Monetization strategy
Roadmap - Project roadmap
Strategic Roadmap - Complete platform roadmap and milestones
Manifesto - Project manifesto
Business Documentation
Marketing - Marketing materials
Press - Press releases and media
Pitch Deck - Pitch deck materials
Publications - Published articles and papers
🔐 Security & Identity
Security Configuration Guide - ✅ ENTERPRISE SECURITY Complete security configuration: encrypted vault management, authentication & authorization, advanced rate limiting, network security, input validation, security monitoring, and incident response procedures
Security Documentation - Security practices and policies
Identity Management Overhaul Report - Identity system overhaul
Guardian Agent - Security agent documentation
Coral ID Agent - CrossMint identity integration
Production Security Features
AES-256 Encrypted Vault: All sensitive data encrypted with enterprise-grade security
Multi-Algorithm Rate Limiting: Sliding window, token bucket, and adaptive rate limiting with client reputation
Wallet-Based Authentication: Ethereum signature-based authentication with session management
Security Middleware: Comprehensive request validation, CORS protection, and threat detection
Security Monitoring: Real-time monitoring, failed authentication tracking, and automated alerting
🚀 Production Operations
Enterprise Deployment Ready
Production Deployment Guide - Complete automated VPS deployment with security hardening
Security Configuration Guide - Enterprise-grade security setup and configuration
API Documentation - Complete API reference with authentication and SDK examples
Production Infrastructure
Automated Deployment: One-command production deployment with ./deploy/production_deploy.sh
Security Hardening: UFW firewall, fail2ban intrusion prevention, SSL certificates, security headers
Performance Optimization: Connection pooling (PostgreSQL, Redis, HTTP), async/await optimization, circuit breaker pattern
Monitoring & Alerting: Health checks, performance monitoring, error tracking, log analysis
Backup & Recovery: Automated backups, encryption, disaster recovery procedures
Production Services
nginx Load Balancer: Rate limiting, SSL termination, security headers, upstream health checks
systemd Service Management: Secure service configuration, automatic restart, health monitoring
PostgreSQL Database: Optimized configuration, connection pooling, backup automation
Redis Caching: Session storage, rate limiting, performance optimization
Encrypted Vault: AES-256 encryption for all sensitive data with PBKDF2 key derivation
Production Security
Multi-Layer Authentication: Wallet signatures, session tokens, API key validation
Advanced Rate Limiting: Multiple algorithms with client reputation and burst protection
Network Security: CORS restrictions, security headers, firewall rules, DDoS protection
Input Validation: Comprehensive sanitization, SQL injection prevention, XSS protection
Security Monitoring: Real-time threat detection, failed authentication tracking, automated alerts
🌐 API & Integration
Interactive API reference: When the backend is running (default port 8000), http://localhost:8000/docs (FastAPI Swagger UI) shows all API endpoints and lets you try requests and inspect schemas—the best way to explore and audit API interactions.
LLM Providers & External Intelligence
External Intelligence Agnostic Architecture: mindX is designed to be external intelligence agnostic. The system does not depend on any specific external LLM provider until mindXagent replicates itself into a model. During this replication process, mindXagent makes decisions from a choice of THOT (Transferable Hyper-Optimized Tensors) processes, enabling the creation of sovereign AI models.
Current Implementation:
Ollama Integration - GPU-accelerated local inference server (10.0.0.155:18080) for high-performance model serving
Ollama Admin - Professional admin interface for Ollama connection management, diagnostics, and interaction testing
Gemini Handler - Google Gemini integration (optional external provider)
Mistral API - Mistral AI integration (optional external provider)
Model Registry - Model registry system for tracking available models
Model Selector - Intelligent model selection system
Multimodel Agent - Multi-model agent system for provider abstraction
THOT-Based Model Replication: When mindXagent replicates itself into a model, it uses the THOT ecosystem to create, optimize, and deploy neural network tensors as tradeable NFT assets. This enables mindX to evolve from external intelligence dependency to sovereign AI model creation.
External Integrations
GitHub Agent - GitHub integration with comprehensive UI controls, backup automation, schedule management, and repository synchronization. The GitHub Agent Tool is fully integrated into the mindX frontend, providing a dedicated section in the Control tab with status monitoring, backup operations, and direct repository access. See GitHub Agent Documentation for architecture, operations, and UI integration details.
CrossMint Integration - CrossMint NFT integration
📊 Research & Development
Academic & Research
Thesis - Research thesis
Evaluation - System evaluation
Historical Documentation - Historical context
Autonomous Civilization - Autonomous civilization research
DAIO & Blockchain
DAIO - DAIO system documentation
DAIO Civilization Governance - DAIO governance
Knowledge Hierarchy DAIO - Knowledge hierarchy
THOT Ecosystem (Transferable Hyper-Optimized Tensors)
The THOT ecosystem provides comprehensive lifecycle management for neural network tensors as tradeable NFT assets. This system enables mindXagent to replicate itself into sovereign AI models, making decisions from a choice of THOT processes rather than depending on external intelligence providers.
Key Concept: mindX is external intelligence agnostic until mindXagent replicates itself into a model. During replication, mindXagent selects from available THOT processes to create optimized neural network models that can operate independently.
Core Contracts (daio/contracts/THOT/core/):
THOT.sol - Basic THOT NFT with dataCID and dimensions
THOTTensorNFT.sol - Enhanced tensor NFT with comprehensive metadata, performance metrics, and version control
THINK.sol - Batch THOT creation (ERC1155)
tNFT.sol - Decision-making THOT NFT
Lifecycle Management (daio/contracts/THOT/lifecycle/):
THOTRegistry.sol - Central catalog and discovery system for all THOTs
THOTDeploymentEngine.sol - On-demand deployment sessions with metrics tracking
THOTRating.sol - Community rating and reputation system
THOTVersionControl.sol - Version history and optimization tracking
Marketplace (daio/contracts/THOT/marketplace/):
AgenticPlace.sol - Foundational marketplace for THOT, NFRLT, AgentFactory NFTs
THOTMarketplace.sol - Specialized THOT marketplace with rental, subscription, and performance-based discovery
IAgenticPlace.sol - Marketplace interface
Integration Layer (daio/contracts/THOT/integration/):
THOTiNFTBridge.sol - Integration between THOTTensorNFT and IntelligentNFT with auto-sync
THOTLifecycle.sol - Orchestration contract tying together the entire THOT ecosystem
NFT Components (daio/contracts/THOT/nft/):
NFRLT.sol - NFT Royalty Token with multi-recipient distribution and soulbound support
gNFT.sol - Graphics NFT for THOT visualization
NFPrompT.sol - Agent Prompt NFT
Automation (daio/contracts/THOT/agents/):
TransmuteAgent.sol - Automated THOT creation from raw data
Interfaces (daio/contracts/THOT/interfaces/):
ITHOTTensorNFT.sol - Core tensor NFT interface
ITHOTRegistry.sol - Registry interface
ITHOTDeployment.sol - Deployment interface
ITHOTMarketplace.sol - Marketplace interface
Architecture Documentation:
THOT Ecosystem Architecture - Complete integration specification: Creation → Cataloging → Marketplace
User Journeys:
Create → Optimize → List → Sell: Full lifecycle from tensor minting to marketplace sale
Create → Link to iNFT → Deploy → Rent: Integration with IntelligentNFT and rental marketplace
Transmute Data → Auto-Register → Catalog: Automated THOT creation via TransmuteAgent
🎨 Specialized Documentation
Agent-Specific
AutoMINDX Enhanced Summary - AutoMINDX enhancements
AutoMINDX iNFT Summary - AutoMINDX NFT integration
AutoMINDX and Personas - Persona management
Mastermind CLI - Mastermind command-line interface
Tool-Specific
Base Gen Agent - Codebase documentation generator agent (Located in agents/utility/)
Base Gen Agent Optimization - Optimization details
Documentation Agent - Documentation generation
📝 Quick Reference
By Component Type
Agents: agents/index.md
Tools: TOOLS_INDEX.md
Core Systems: See Core Systems section above
Monitoring: See Monitoring & Performance section above
By Function
Cognitive Systems: BDI Agent, Belief System, AGInt
Orchestration: Coordinator Agent, Mastermind Agent, CEO Agent
Learning: Strategic Evolution Agent, Goal Management, Plan Management
Monitoring: Performance Monitor, Resource Monitor, Error Recovery
Identity: Guardian Agent, ID Manager, Coral ID Agent
Vault & Auth: Wallet sign-in → vault-backed session; GET /users/session/validate, POST /users/logout; vault user folders GET/PUT/DELETE /vault/user/keys; access gate (optional ERC20/ERC721); frontend vault_manager.js; LIT_AND_ACCESS_ISSUANCE; DAIO keyminter (VaultKeyDynamic, VaultKeyIntelligent)
Development: Simple Coder, Enhanced Simple Coder, Code Generation Tools
🔗 Quick Links
Primary Indexes
Agents Index - Complete agent registry and documentation
Tools Index - Complete tool registry and documentation
System Architecture Map - System architecture overview
Getting Started
README - Start here for project overview
Usage Guide - Usage instructions
Technical Documentation - Technical specifications
Key Systems
Coordinator Agent - Central orchestration system
Mastermind Agent - Strategic intelligence layer
BDI Agent - Cognitive architecture foundation
Memory Agent - Memory and persistence system
📈 Documentation Statistics
Total Documentation Files: 175+ (Updated 2026-03-31)
Agent Documentation: 34+ files
Tool Documentation: 29+ files
System Documentation: 55+ files (including production guides)
Production Documentation: 4 comprehensive guides (deployment, security, API, academic)
Guides & Tutorials: 25+ files (including production operations)
Analysis & Reports: 15+ files
NFT-Ready Documentation: 100% of agents and tools
Production Ready: ✅ Enterprise deployment and security documentation complete
🎯 Documentation Standards
All agent and tool documentation follows consistent standards:
Technical Explanation: Detailed technical architecture
Usage Examples: Code examples and usage patterns
NFT Metadata: iNFT/dNFT ready metadata
Integration Details: Integration with other components
File Locations: Source code locations
Blockchain Publication: Publication readiness
See agents/index.md for agent documentation standards and TOOLS_INDEX.md for tool documentation standards.
🧠 Architecture Philosophy: External Intelligence Agnosticism
Core Design Principle
mindX is external intelligence agnostic until mindXagent replicates itself into a model. The system architecture is designed to:
Operate Independently: Function without dependency on external LLM providers
GPU-Accelerated Inference: Use Ollama on graphics card (10.0.0.155:18080) for high-performance local inference
THOT-Based Replication: Enable mindXagent to replicate itself into sovereign AI models through THOT processes
Decision Making: Allow mindXagent to make decisions from a choice of THOT processes during replication
Evolution Path
External Intelligence Agnostic Phase
↓
Ollama GPU Inference (10.0.0.155:18080)
↓
mindXagent Self-Replication
↓
THOT Process Selection
↓
Sovereign AI Model Creation
Current State
✅ External Intelligence Agnostic: System operates without requiring external LLM providers
✅ GPU-Optimized: Ollama server on dedicated graphics card for high-performance inference
✅ THOT Integration: Complete THOT ecosystem for model creation and optimization
🔄 Replication Capability: mindXagent can replicate itself into models via THOT processes
🔮 Sovereign AI: Path to independent AI model operation
See System Architecture Map for complete architectural details.
🆕 Production Systems (April 2026)
BANKON Vault
Credential Storage: AES-256-GCM + HKDF-SHA512 encrypted vault
Files: mindx_backend_service/bankon_vault/vault.py, credential_provider.py, routes.py
CLI: manage_credentials.py — store, list, delete, providers
13 provider templates: config/providers/.env
pgvector Memory Backend
Database: PostgreSQL 16 + pgvector 0.6.0
Tables: memories, beliefs, agents, godel_choices, actions, model_perf
Backend: agents/memory_pgvector.py — async connection pool, dual-write with file fallback
Migration: scripts/migrate_to_pgvector.py
Inference Discovery & Multi-Stream
Discovery: llm/inference_discovery.py — probes all sources, auto-selects best provider
Multi-Stream: llm/multi_stream.py — parallel queries with consensus strategies
vLLM Handler: llm/vllm_handler.py — OpenAI-compatible API integration
Endpoints: /inference/status, /inference/probe, /inference/multi-stream
DAIO Governance (Algorand + EVM)
BONA FIDE ASA: daio/contracts/algorand/bona_fide.algo.ts — Algorand verification token with clawback
Agent Map: daio/agents/agent_map.json — canonical registry with reputation, groups, verification tiers
Boardroom: daio/governance/boardroom.py — CEO + Seven Soldiers weighted consensus
Dojo: daio/governance/dojo.py — reputation ranks (Novice→Sovereign), BONA FIDE privilege system
Endpoints: /boardroom/convene, /dojo/standings, /dojo/agent/{id}
Live Diagnostics Dashboard
Dashboard: mindx_backend_service/dashboard.html — animated agent network, real-time metrics
Heartbeat: Local model (qwen3:0.6b) self-reflection every 60s, CPU-aware throttling
Toast Notifications: New interactions popup, hang 12s, settle into dialogue panel
Endpoints: / (dashboard), /diagnostics/live (JSON), /docs.html (documentation hub)
AuthorAgent & Documentation
AuthorAgent: agents/author_agent.py — publishes The Book of mindX every 2 hours
Improvement Journal: agents/learning/improvement_journal.py — auto-updates every 30 min
Doc Reader: /doc/{name} — renders any of 194 docs as styled HTML
Endpoints: /book, /journal, /docs.html (TOC)
API Access Gate
Middleware: All non-public routes require X-Session-Token or Authorization: Bearer <api_key>
Public: /, /health, /docs.html, /doc/, /book, /journal, /diagnostics/live, /dojo/standings
Gated: Everything else returns 401 without valid auth
Agent Identity Genesis
Script: scripts/genesis_production_identities.py — generates fresh wallets, stores in BANKON Vault
12 sovereign agents with verified Ethereum-compatible identities
Registry: data/identity/production_registry.json (public addresses only)
Last Updated: 2026-04-03 (Documentation Audit & pgvector Migration)
Maintained By: mindX Documentation System + AuthorAgent
Production Status: ✅ Enterprise-ready with pgvector, BANKON Vault, live diagnostics
For Issues: See project repository
Referenced in this document