Repository navigation
INSTALLATION
This guide provides detailed instructions for installing and setting up the AEGIS system on your local machine.
- CPU: Modern multi-core processor (Intel i5/AMD Ryzen 5 or better recommended)
- RAM: Minimum 8GB (16GB recommended for optimal performance)
- Storage: At least 20GB of free disk space
- GPU: Optional but recommended for ML components (CUDA-compatible GPU)
-
Operating System:
- Windows 10/11 (64-bit)
- Linux (Ubuntu 20.04+, CentOS 8+, or equivalent)
- macOS 10.15+ (Catalina or later)
- Python: Version 3.8 or higher
- Git: For cloning the repository
- Docker: For containerized deployments (optional but recommended)
- Internet Connection: For downloading dependencies
-
Install Python:
- Download Python 3.8+ from python.org
- During installation, check "Add Python to PATH"
- Verify installation:
python --version
-
Install Git:
- Download Git from git-scm.com
- Follow the installation wizard with default settings
- Verify installation:
git --version
# Update package list
sudo apt update
# Install Python and pip
sudo apt install python3 python3-pip
# Install Git
sudo apt install git
# Install Docker (optional)
sudo apt install docker.io
sudo usermod -aG docker $USER-
Install Homebrew (if not already installed):
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" -
Install Python and Git:
brew install python git
# Clone the AEGIS repository
git clone https://github.com/RealDaniG/AEGIS.git
# Navigate to the project directory
cd AEGISUse the provided installation scripts:
Windows:
# Run the installation script
install.batLinux/macOS:
# Make the script executable
chmod +x install.sh
# Run the installation script
./install.shIf you prefer manual installation:
-
Create a Virtual Environment (recommended):
# Create virtual environment python -m venv aegis-env # Activate virtual environment # Windows: aegis-env\Scripts\activate # Linux/macOS: source aegis-env/bin/activate
-
Install Core Dependencies:
# Install main requirements pip install -r requirements.txt # Install Metatron-ConscienceAI requirements cd Metatron-ConscienceAI pip install -r requirements.txt cd .. # Install Open-A.G.I requirements cd Open-A.G.I pip install -r requirements.txt cd .. # Install aegis-conscience requirements cd aegis-conscience pip install -r requirements.txt cd .. # Install unified system requirements pip install -r unified_requirements.txt
-
Install Visualization Dependencies:
# Install visualization tools dependencies pip install websockets requests plotly
Create a .env file in the project root with the following configuration:
# System Configuration
AEGIS_PORT=8005
AEGIS_WS_PORT=8006
AEGIS_DEBUG=false
# Database Configuration (if using)
DATABASE_URL=sqlite:///aegis.db
# Security Configuration
SECRET_KEY=your-secret-key-here
JWT_SECRET_KEY=your-jwt-secret-here
# TOR Configuration (if using)
TOR_PROXY_HOST=127.0.0.1
TOR_PROXY_PORT=9050For custom node configuration, create a node_config.json file:
{
"node_id": "aegis-node-001",
"network": {
"host": "0.0.0.0",
"port": 8005,
"ws_port": 8006
},
"security": {
"enable_tls": false,
"enable_tor": false
},
"modules": {
"consciousness_engine": true,
"agi_framework": true,
"decision_engine": true
}
}Windows:
run_everything.batLinux/macOS:
chmod +x run_everything.sh
./run_everything.sh-
Start the Unified System Coordinator:
python start_unified_system.py
-
Start Visualization Tools (in a separate terminal):
cd visualization_tools python robust_realtime_visualizer.py
Once the system is running, verify it's working correctly:
-
Health Check Endpoint:
curl http://localhost:8003/health
-
API Documentation: Open your browser and navigate to: http://localhost:8003/docs
-
Visualization Window: Check that the visualization window opens and displays real-time metrics
-
Consciousness Metrics:
curl http://localhost:8003/api/consciousness
-
AGI Status:
curl http://localhost:8003/api/agi
-
System State:
curl http://localhost:8003/state
-
Permission Denied Errors:
- On Linux/macOS, try using
sudofor system-wide installations - Ensure you have write permissions to the installation directory
- On Linux/macOS, try using
-
Python Version Issues:
- Verify you're using Python 3.8 or higher:
python --version - If multiple Python versions are installed, use
python3instead ofpython
- Verify you're using Python 3.8 or higher:
-
Missing Dependencies:
- Ensure all requirements files are installed
- Check internet connectivity for package downloads
-
Port Already in Use:
- Check if another instance is running:
netstat -an | grep 8005 - Kill the existing process or change the port configuration
- Check if another instance is running:
-
Connection Refused:
- Verify the system is running
- Check firewall settings
- Ensure localhost connections are allowed
-
Module Import Errors:
- Verify all dependencies are installed
- Check that you're in the correct virtual environment
- Reinstall missing packages:
pip install package-name
For containerized deployment:
-
Build Docker Images:
docker-compose build
-
Run Containers:
docker-compose up
-
CPU Usage:
- Adjust the number of worker processes in configuration
- Limit CPU usage with Docker resource constraints
-
Memory Usage:
- Monitor memory consumption with system tools
- Adjust batch sizes for ML components
-
Network Optimization:
- Use local network for better performance
- Enable compression for large data transfers
-
Custom Logging: Configure log levels and output destinations in the logging configuration file.
-
Security Hardening:
- Enable TLS for secure communication
- Configure firewall rules
- Use strong authentication mechanisms
-
Backup and Recovery:
- Regular database backups
- Configuration file versioning
- Disaster recovery procedures
-
Pull Latest Changes:
git pull origin master
-
Update Dependencies:
pip install -r requirements.txt --upgrade
-
Restart Services: Stop and restart the system to apply updates.
-
System Logs: Check log files in the
logs/directory for system events. -
Performance Metrics: Use the visualization tools to monitor system performance.
-
Health Checks: Regular health checks via the API endpoints.
If you encounter issues during installation:
- Check the console output for error messages
- Verify all prerequisites are met
- Consult the full documentation in the GitHub Wiki
- Contact the repository owner for support
Developed with ❤️ for the advancement of consciousness-aware AI