mindX is a production-grade autonomous Augmented Intelligence system implementing the Godel-machine architecture with multi-agent orchestration, encrypted vault management, and comprehensive security hardening.
Author: Professor Codephreak (© Professor Codephreak) Organizations: github.com/agenticplace, github.com/cryptoagi, github.com/Professor-Codephreak Resources: rage.pythai.net
mindX represents an implementation of a godel machine - a fully self-improving, economically viable, and cryptographically secure multi-agent system. We are building agents and creating a sovereign digital polity where Augmented Intelligence operates independently, evolves continuously, and participates in economic systems.
Machine Learning capabilities include advanced pattern recognition, autonomous decision-making, and continuous learning from operational data with encrypted memory management.
Meta-Orchestration:
0xb9B46126551652eb58598F1285aC5E86E5CcfB43): Strategic control and AION directive managementCognitive Architecture:
0xf8f2da254D4a3F461e0472c65221B26fB4e91fB7): Core reasoning engine with tool execution (~64KB)0x24C61a2d0e4C4C90386018B43b0DF72B6C6611e2): P-O-D-A cognitive loop orchestratorInfrastructure Services:
0x7371e20033f65aB598E4fADEb5B4e400Ef22040A): Central service bus with pub/sub system (~56KB)0x290bB0497dBDbC5E8B577E0cc92457cB015A2a1f): Cryptographic identity ledger0xC2cca3d6F29dF17D1999CFE0458BC3DEc024F02D): Security infrastructure and access controlCore Utilities:
Strategic Services:
0x5208088F9C7c45a38f2a19B6114E3C5D17375C65): 4-phase audit-driven improvement pipelineAutonomous Operations:
Development & Analysis:
Monitoring & Health:
mistral-large-latest): Advanced reasoning and strategic thinkingcodestral-latest): Autonomous code generation and software developmentmistral-nemo-latest): High-speed processing for real-time operationsmistral-embed-v2): Semantic memory and knowledge retrieval# Install Python dependencies
pip install -r requirements.txt
Ensure Python 3.11+ is available
python3 --version
# Copy and configure environment
cp .env.sample .env
Add your Mistral AI API key
echo "MISTRAL_API_KEY=your-mistral-api-key-here" >> .env
Optional: Configure other API keys
echo "OPENAI_API_KEY=your-openai-key" >> .env
echo "ANTHROPIC_API_KEY=your-anthropic-key" >> .env
# Start MindX with enhanced web interface (backend + frontend)
./mindX.sh --frontend
Features: Real-time monitoring, health status, agent management, system metrics
Access: http://localhost:3000 (Frontend) + http://localhost:8000 (Backend API)
# Basic deployment (backend + frontend services)
./mindX.sh --run
Interactive setup with API key configuration
./mindX.sh --interactive
Deploy to specific directory
./mindX.sh /path/to/deployment/directory
Custom ports
./mindX.sh --frontend --frontend-port 3001 --backend-port 8001
Use existing configuration files
./mindX.sh --config-file /path/to/mindx_config.json --dotenv-file /path/to/.env
# Show help and all available options
./mindX.sh --help
Available options:
--frontend # Start enhanced web interface (recommended)
--run # Start backend and frontend services
--interactive # Prompt for API keys during setup
--replicate # Copy source code to target directory
--config-file <path> # Use existing mindx_config.json
--dotenv-file <path> # Use existing .env file
--venv-name <name> # Override virtual environment name
--frontend-port <port> # Override frontend port (default: 3000)
--backend-port <port> # Override backend port (default: 8000)
--log-level <level> # Set log level (DEBUG, INFO, etc.)
# 1. First-time setup with interactive API key configuration
./mindX.sh --frontend --interactive
2. Production deployment with custom configuration
./mindX.sh --frontend --config-file production_config.json
3. Development setup with custom ports
./mindX.sh --frontend --frontend-port 3001 --backend-port 8001
4. Full system deployment without web interface
./mindX.sh --run
# Direct execution (legacy)
python3 augmentic.py
Web interface launcher (legacy)
./run_mindx_web.sh
Simple version (minimal features)
python3 augmentic_simple.py
# Check system status
python3 augmentic.py --status
View agent performance metrics
python3 augmentic.py --metrics
Monitor Mistral AI usage and costs
python3 augmentic.py --costs
Check evolution progress
python3 augmentic.py --evolution
mindX/
├── docs/ # Complete documentation (103+ files)
│ ├── agents_architectural_reference.md
│ ├── mistral_api.md
│ ├── hackathon.md
│ └── [100+ more documentation files]
├── tests/ # Comprehensive test suite (30+ files)
│ ├── test_mistral_chat_completion_api.py
│ ├── test_agent_lifecycle_complete.py
│ └── [25+ more test files]
├── agents/ # Agent implementations
│ ├── mastermind_agent.py
│ ├── guardian_agent.py
│ └── [other agent files]
├── api/ # API components
│ ├── mistral_api.py
│ └── api_server.py
├── core/ # Core system components
│ ├── bdi_agent.py
│ ├── agint.py
│ └── belief_system.py
├── orchestration/ # Orchestration agents
│ ├── coordinator_agent.py
│ └── ceo_agent.py
├── learning/ # Learning and evolution
│ ├── strategic_evolution_agent.py
│ └── self_improve_agent.py
├── monitoring/ # Performance monitoring
│ ├── enhanced_monitoring_system.py
│ └── performance_monitor.py
├── tools/ # Tool ecosystem (27+ tools)
│ ├── audit_and_improve_tool.py
│ ├── augmentic_intelligence_tool.py
│ └── [25+ more tools]
├── models/ # Model configurations
│ ├── mistral.yaml
│ └── gemini.yaml
├── augmentic.py # Main entry point
├── augmentic_simple.py # Simplified version
├── start_autonomous_evolution.py
├── mindX.sh # Enhanced deployment script with web interface
├── run_mindx_web.sh # Legacy web interface launcher (deprecated)
├── mindx_frontend_ui/ # Enhanced frontend UI files
│ ├── index.html # Main HTML interface
│ ├── app.js # Frontend JavaScript with full integration
│ ├── styles3.css # Cyberpunk 2049 theme CSS
│ └── server.js # Frontend server
├── mindx_backend_service/ # Backend API service
│ └── main_service.py # FastAPI backend with all endpoints
├── pyproject.toml # Project configuration
├── requirements.txt # Dependencies
├── .env.sample # Environment template
└── .gitignore # Git ignore rules
# Run all tests
python -m pytest tests/
Run specific test categories
python -m pytest tests/test_mistral_chat_completion_api.py
python -m pytest tests/test_agent_lifecycle_complete.py
Run with coverage
python -m pytest tests/ --cov=.
# Start enhanced web interface
./mindX.sh --frontend
Access URLs:
Frontend: http://localhost:3000
Backend API: http://localhost:8000
API Documentation: http://localhost:8000/docs
mindX is live at https://mindx.pythai.net — Hostinger VPS with SSL, BANKON Vault credential management, and systemd auto-restart.
API keys are stored encrypted in BANKON Vault (AES-256-GCM + HKDF-SHA512). Manage credentials:
python manage_credentials.py store gemini_api_key "YOUR_KEY"
python manage_credentials.py list
python manage_credentials.py providers # Show all supported providers
# Enhanced web interface (recommended)
./mindX.sh --frontend
Basic services deployment
./mindX.sh --run
Custom deployment directory
./mindX.sh /opt/mindx --frontend
Production with custom configuration
./mindX.sh --frontend --config-file production_config.json --dotenv-file .env.prod
# Development with custom ports
./mindX.sh --frontend --frontend-port 3001 --backend-port 8001
Interactive setup for first-time users
./mindX.sh --frontend --interactive
Replicate source code to target directory
./mindX.sh --replicate /path/to/deployment
# Legacy web interface (deprecated)
./run_mindx_web.sh
Docker deployment (if available)
docker build -t mindx .
docker run -p 8000:8000 mindx
# Check what's using the ports
lsof -i :3000 # Frontend port
lsof -i :8000 # Backend port
Kill processes if needed
sudo kill -9 $(lsof -ti:3000)
sudo kill -9 $(lsof -ti:8000)
Use different ports
./mindX.sh --frontend --frontend-port 3001 --backend-port 8001
# Make script executable
chmod +x mindX.sh
Run with proper permissions
sudo ./mindX.sh --frontend
# Ensure Python 3.11+ is installed
python3 --version
Create virtual environment manually
python3 -m venv .mindx_env
source .mindx_env/bin/activate
pip install -r requirements.txt
# Interactive setup for API keys
./mindX.sh --frontend --interactive
Manual .env configuration
cp .env.sample .env
nano .env # Add your API keys
# Check if backend is running
curl http://localhost:8000/health
Check frontend logs
tail -f data/logs/mindx_frontend_service.log
Restart with verbose logging
./mindX.sh --frontend --log-level DEBUG
# Check backend logs
tail -f data/logs/mindx_coordinator_service.log
Test API endpoints
curl http://localhost:8000/
curl http://localhost:8000/status/mastermind
curl http://localhost:8000/health
data/logs/ directory./mindX.sh --help for all available optionshttp://localhost:8000/docsThis is the evolution of mindX - a production-ready godel-machine. The system is designed to operate independently while providing comprehensive documentation and testing capabilities.
MIT License - See LICENSE for details.
Status: ✅ EXPERIMENTAL - Fully Deployed & Operational Achievement: World's first autonomous digital civilization with economic viability Innovation: Complete Mistral AI integration with cryptographic sovereignty Impact: Transforming intelligence from service to stakeholder
Where Intelligence Meets Autonomy - The Dawn of Agentic Sovereignty
(c) 2025 PYTHAI Institute for Emergent Systems