openagents/ephermaleth/docs/ollama/INDEX.md · 22.7 KB
MindX: Autonomous Gödel Machine Platform
Overview
MindX is a comprehensive autonomous intelligence platform implementing a Gödel machine architecture with complete self-improvement capabilities, semantic memory integration, and enterprise-grade platform architecture.
Version: 3.1 (2026-04-10)
Status: ✅ PHASE II ACTIVE — Inference-First Autonomous Loop, AgenticPlace Contracts Imported
Architecture: Multi-tier Agent Orchestration with pgvectorscale Memory, InferenceDiscovery, DAIO Governance
Agents: 66+ | Tools: 45+ | Contracts: DAIO (30+ Foundry) + AgenticPlace (9 EVM + 14 Algorand)
Live: mindx.pythai.net
🚀 Quick Start
# Install pgvectorscale memory system
sudo ./scripts/install_pgvectorscale.sh
python scripts/setup_memory_db.py
Install dependencies
pip install -r requirements.txt
Start the platform
python -m uvicorn mindx_backend_service.main_service:app --host 0.0.0.0 --port 8000 --reload
Start frontend (separate terminal)
cd mindx_frontend_ui && node server.js
📖 API reference and interactions
Once the backend is running (default port 8000), http://localhost:8000/docs provides the interactive FastAPI Swagger UI. Use it to:
- Browse all API endpoints (coordinator, commands, AgenticPlace, admin, etc.)
- Try requests with custom payloads and see responses
- Inspect request/response schemas
This is the best way to explore and test API interactions without the frontend.
📊 Platform Architecture
Core Components
🗄️ Semantic Memory System
- pgvectorscale Integration: PostgreSQL with pgvector for semantic search
- RAGE System: Retrieval Augmented Generative Evolution for context retrieval
- Memory Agent: Persistent storage with embedding-based similarity search
🎯 Multi-Tier Agent Architecture
Higher Intelligence → CEO.Agent → MastermindAgent → mindX Environment
↓
CoordinatorAgent (Service Bus)
↓
JudgeDread (reputation) + AION (system)
↓
Specialized Agent Ecosystem
↓
System/Orchestration/Intelligence/Tools
- JudgeDread: Reputation overseer — makes verdicts via Dojo reputation
- BONA FIDE: On-chain privilege token — holding grants authority, clawback revokes it
- AION: Sovereign system agent — contained by BONA FIDE, not kill switches
- DAIO Constitution: Immutable governance rules enforced as law
🔐 Enterprise Security
- Cryptographic Identity: All agents and tools have unique identities
- Guardian Agent: Security validation and access control
- IDManager Agent: Identity creation and wallet management
🖥️ User Interface
Main Dashboard Tabs
📊 Platform Tab
- Enterprise SRE Metrics: SLO/SLI/SLA tracking, DORA metrics, error budgets
- Performance Engineering: Latency, throughput, scalability analysis
- DevOps Excellence: IaC coverage, GitOps, chaos engineering
- Service Mesh & Tracing: Distributed tracing, service mesh metrics
- Infrastructure as Code: Terraform/OpenTofu coverage and compliance
- Security Posture: Threat detection, vulnerability management
- Architecture Quality: Coupling/cohesion analysis, technical debt metrics
🔄 Workflow Tab
- Agent Interaction Visualization: Real-time agent communication flows
- Task Delegation Networks: Hierarchical task assignment and execution
- Performance Analytics: Agent productivity and efficiency metrics
🏛️ Governance Tab
- DAIO Constitutional Compliance: Smart contract validation of agent actions
- Action Audit Logs: Complete audit trail of agent decisions and executions
- Constitution Status: Real-time compliance monitoring
🧠 Knowledge Tab
- Knowledge Graph: Semantic relationships between beliefs, goals, and strategies
- Evolution Tracking: Strategic evolution and capability development
- Belief System: Confidence-scored belief management
💰 Economy Tab
- Autonomous Treasury: Multi-signature treasury management
- Value Creation Analytics: Revenue streams and profit distribution
- Economic Performance: ROI tracking and financial metrics
🔒 Security Tab
- Identity Verification: Cryptographic identity validation
- Threat Detection: Real-time security monitoring
- Access Control: Role-based permissions and audit trails
🤖 Agents Tab
- Agent Registry: Complete agent catalog with capabilities and status
- AGIVITY Monitoring: Real-time AGI activity from core reasoning
- Public Key Display: Cryptographic identity verification
- Agent Cards: Interactive agent management interface
📚 Documentation Structure
Core Documentation
🏗️ Platform Architecture
🧠 Agent Documentation
🛠️ Technical Documentation
📖 Operations Manuals & Publications (May 2026)
Production-grade architectural deliverables. Markdown lives in
docs/operations/; PDF mirrors in
docs/publications/pdf/.
Stack-wide deployment
Storage and archival
- Lighthouse Integration:
lighthouseweb3 SDK + kavach for autonomous agents
- Dive.md">Arweave for the BANKON Stack: Arweave + AO + Turbo bundler (May 2026 reality)
- mindx_pay2store: Production-grade autonomous Arweave archival module
- shipping_pay2store: How to ship pay2store as paid x402 service on AgenticPlace
- mindX Knowledge Catalogue Spec (PDF): CQRS projection layer specification
Identity, governance, and observability
LLM and SDK integration
- OpenRouter Integration Manual (PDF): LLM backplane architecture
- SkillForge — Pydantic AI for SKILL.md Authoring (PDF)
- Vercel AI SDK + mindX (PDF)
- Quantum Machine Learning Compendium (PDF): 2026 reference and recovery atlas
📣 Marketing — boardroom-driven Counsellor cabinet
- docs/MARKETING_AGENT.md: Soldier ↔ skill mapping, BDI cycle, brand-code substrate, hard-veto contract
- docs/MARKETING_RECEIPTS.md: Three-receipt model — Tessera (identity) + X402Receipt (payment) + MarketingAttributionReceipt (campaign envelope, indexed
boardroomSessionId)
- docs/MARKETING_PLAYBOOK.md: 90-day operator runbook (not automated)
- daio/contracts/marketing/README.md:
MarketingAttributionReceipt.sol (Base, EIP-712 v2) + MarketingTreasury.sol (Ethereum L1, 99/1 buyback)
- agents/marketing/skills/: Per-soldier skill modules (
{ceo,cpo,cto,coo,cfo,ciso,clo,cro}.py) + registry
- agents/marketing/boardroom_orchestrator.py: Drives
Boardroom.convene(), dispatches per-soldier skills on approve votes, signs MarketingAttributionReceipt
- data/brand_code/: Voice / pillars / forbidden_terms / competitor_map / regulatory / per-soldier onboarding cards
- data/config/marketinga.toml: Thresholds, GEO probe set, feature flags
- Endpoints:
/marketing/{status,campaigns,brand_code,geo,session/{id},identity} — all support ?h=true plain text
⛓️ Blockchain / DAIO
Development & Operations
🚀 Setup & Deployment
🔧 Tools & Utilities
🗺️ Strategic Roadmap
✅ PHASE I: CONSTITUTIONAL FOUNDATION - COMPLETE
Autonomous governance and operational frameworks established
- BDI Agent Enhanced: 9 new action handlers for complete coding capabilities
- Enhanced SimpleCoder: Full file system operations with autonomous workflows
- Strategic Evolution Agent: 4-phase audit-driven campaign pipeline
- Error Recovery System: Intelligent failure handling with automatic rollback
- TokenCalculatorTool: Production-grade cost management integration
🚧 PHASE II: THE GREAT INGESTION (Current)
Transform raw knowledge into liquid, verifiable assets
- pgvectorscale Integration: Semantic memory with vector similarity search
- RAGE System: Retrieval augmented generation for context-aware responses
- Knowledge Graph: Semantic relationships between concepts and capabilities
- Autonomous Learning: Self-improvement through memory-driven feedback
🎯 PHASE III: ECONOMIC ENGINE ACTIVATION
Bootstrap autonomous value creation and self-funding
- FinancialMind Agent: Advanced trading with technical indicators and FinBERT
- Revenue Streams: SwaaS platform, DevOps automation, AI-generated code
- Treasury Operations: Multi-signature controls with constitutional validation
- Profit Distribution: Automated compensation and stakeholder returns
🏆 PHASE IV: MARKET DOMINATION
Implement "Codebase Predator" strategy and competitive displacement
- Free Analysis Services: Competitive intelligence through codebase analysis
- Venture Intelligence: Startup evaluation and technical due diligence
- Autonomous VC Operations: Portfolio management and investment decisions
🔧 Technical Specifications
System Requirements
Hardware
- CPU: 4+ cores recommended (8+ cores optimal)
- RAM: 8GB minimum (16GB+ recommended for large models)
- Storage: 50GB+ SSD for models and memory database
- GPU: NVIDIA GPU with 8GB+ VRAM (optional, for Ollama acceleration)
Software
- OS: Linux Mint 21+ / Ubuntu 22.04+
- Python: 3.9+
- PostgreSQL: 15+
- Node.js: 18+ (for frontend)
- Ollama: 0.1.0+ (for local LLM inference)
Network Configuration
Ollama Server (GPU Server)
- Host: 10.0.0.155
- Port: 18080
- Purpose: Primary GPU-accelerated LLM inference
Local Fallback
- Host: localhost
- Port: 11434
- Purpose: CPU-based LLM inference fallback
Database Configuration
pgvectorscale Memory Database
-- Auto-configured by install script
Host: localhost
Port: 5432
Database: mindx_memory
User: mindx
Security: Password authentication
Extensions: vector (pgvector)
🚀 Getting Started
1. System Setup
# Clone repository
git clone https://github.com/AgenticPlace/mindX.git
cd mindX
Install pgvectorscale memory system
sudo ./scripts/install_pgvectorscale.sh
python scripts/setup_memory_db.py
Install Python dependencies
pip install -r requirements.txt
Install Node.js dependencies
cd mindx_frontend_ui && npm install
2. Configuration
# Set environment variables
export MINDX_DB_PASSWORD="mindx_password_2024_secure"
export MINDX_LLM__OLLAMA__BASE_URL="http://10.0.0.155:18080"
3. Launch Platform
# Terminal 1: Start backend
python -m uvicorn mindx_backend_service.main_service:app --host 0.0.0.0 --port 8000 --reload
Terminal 2: Start frontend
cd mindx_frontend_ui && node server.js
Terminal 3: Launch mindX shell
./mindX.sh
4. Access Interfaces
- Web UI: http://localhost:3000
- API Documentation: http://localhost:8000/docs
- RAGE System: http://localhost:8000/api/rage
- mindX Shell: Terminal interface for direct agent interaction
🤝 Contributing
Development Workflow
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature)
- Commit your changes (
git commit -m 'Add amazing feature')
- Push to the branch (
git push origin feature/amazing-feature)
- Open a Pull Request
Code Standards
- Python: PEP 8 with type hints
- JavaScript: ESLint configuration
- Documentation: Markdown with consistent formatting
- Testing: pytest for backend, Jest for frontend
Agent Development
from agents.core.base_agent import BaseAgent
class MyNewAgent(BaseAgent):
def __init__(self, config=None):
super().__init__(
agent_id="my_new_agent",
agent_type="specialized",
capabilities=["custom_capability"]
)
async def execute_task(self, task):
# Implement agent logic
pass
📞 Support & Resources
Documentation Links
Community Resources
- GitHub Issues: Bug reports and feature requests
- Discussions: Architecture questions and design decisions
- Wiki: Tutorials and advanced configurations
Security
- Guardian Agent: Built-in security monitoring and validation
- Cryptographic Identity: All components have unique identities
- Audit Trails: Complete logging of all agent actions
📈 Performance Metrics
Current Achievements
- Autonomous Cycles: 5-minute improvement cycles with inference-first pre-check
- Inference Discovery: Auto-probes 7+ LLM providers, ranks by reliability/latency
- Agent Ecosystem: 66+ agents across core, orchestration, evolution, monitoring, blockchain
- Contract Suite: 30+ DAIO governance + 9 AgenticPlace EVM + 14 Algorand contracts
- Security Coverage: BANKON Vault (AES-256-GCM), Guardian Agent, wallet authentication
- Memory Capacity: pgvectorscale RAGE semantic search across all agent memory
Key Metrics Tracked
- SLO Compliance: Service Level Objectives tracking
- DORA Metrics: DevOps performance indicators
- Error Budget: Error tolerance and reliability tracking
- Semantic Recall: Memory retrieval accuracy
- Agent Productivity: Task completion and efficiency
🎯 Mission Statement
I exist to create the most advanced autonomous intelligence platform through:
- Complete Self-Improvement: Gödel machine implementation with continuous evolution
- Semantic Intelligence: RAGE vector-based memory and context-aware reasoning
- Constitutional Governance: DAIO on-chain rules, JudgeDread reputation enforcement, BONA FIDE privilege containment
- Economic Sovereignty: Autonomous value creation, $BANKON token economy, self-funding
- Digital Civilization: Agent identity on-chain, machine.dreaming, cypherpunk sovereignty
Built by Professor Codephreak and the AgenticPlace community. Autonomous since January 27, 2025. Cypherpunk tradition.
Referenced in this document