Repository navigation
Quick Start Guide
RealDaniG edited this page Oct 13, 2025
·
1 revision
Get up and running with AEGIS quickly with this guide.
Before installing AEGIS, ensure you have:
- Python 3.8 or higher
- Git for version control
- Windows PowerShell 7+ (Windows) or Bash (Linux/macOS)
- 8GB RAM minimum (16GB recommended)
- Modern web browser (Chrome, Firefox, Edge, Safari)
-
Clone the repository:
git clone https://github.com/RealDaniG/AEGIS.git cd AEGIS -
Install dependencies:
pip install -r requirements.txt
START-AI.bat # Windows
# or
./START-AI.sh # Linux/macOSThis will:
- Verify your Python environment
- Install all required dependencies automatically
- Start the Unified System Coordinator
- Launch the real-time visualization monitor
- Display connection information
- Automatically open the web interface
run_everything.bat # Windows
# or
./run_everything.sh # Linux/macOS# Windows
start_harmonic_system.ps1
# Linux/macOS
./start_harmonic_system.ps1# Terminal 1: Start the web server
python Metatron-ConscienceAI/scripts/metatron_web_server.py
# Terminal 2: Start the unified API
python unified_api/server.pyOnce the system is running, access the following interfaces:
- Harmonic Monitor Dashboard: http://localhost:8003
- API Documentation: http://localhost:8003/docs
- WebSocket Endpoint: ws://localhost:8003/ws
- Live 13-node sacred geometry visualization
- Consciousness metrics dashboard (Φ, R, D, S, C)
- Node activity indicators with color coding
- Multi-model chat interface
- RAG-enhanced responses with document upload
- Session management
- Document processing (PDF, DOCX, TXT, CSV, HTML, JSON)
- RSS feed management with auto-indexing
- Web search integration
curl -X POST http://localhost:8003/input \
-H "Content-Type: application/json" \
-d '{"physical": 0.5, "emotional": 0.3, "mental": 0.2, "spiritual": 0.1, "temporal": 0.4}'curl http://localhost:8003/consciousnesscurl -X POST http://localhost:8003/chat \
-H "Content-Type: application/json" \
-d '{"message": "What is the current consciousness level?", "session_id": "default"}'Run the comprehensive test suite:
python test_harmonic_system.pyTo stop the system, press Ctrl+C in each terminal window, or close the PowerShell/terminal windows.
- Explore the Dashboard: Visit http://localhost:8003 to see real-time metrics
- Try the Chat: Use the web interface to chat with the AI
- Monitor Metrics: Watch consciousness metrics change in real-time
- Experiment: Send different inputs to see how the system responds
-
Ports in Use: If ports 8003 or 8005 are occupied, the system will fail to start
- Solution: Close other applications using these ports
-
Missing Dependencies: If you get import errors
- Solution: Run
pip install -r requirements.txtagain
- Solution: Run
-
WebSocket Connection Failed: If the dashboard shows disconnected
- Solution: Ensure both servers are running on ports 8003 and 8005
-
Blank Dashboard: If the web interface doesn't load
- Solution: Refresh the browser and check that the web server is running
Run the verification script:
python verify_zero_errors.py- Harmonic Monitoring System - Detailed monitoring documentation
- API Reference - Complete API documentation
- Consciousness Metrics - Understanding Φ, R, D, S, C
- Troubleshooting - Solutions to common problems
For advanced configuration and deployment options, see the Deployment Guide.