Customization
Environment Configuration
Configure environment variables and system settings
Configure your system environment to work optimally with CUGA, including system paths and container management.
🐍 Python Environment
Virtual Environment Setup
CUGA requires Python 3.12+ in a virtual environment:
# Create virtual environment
uv venv --python=3.12
# Activate environment
source .venv/bin/activate # macOS/Linux
# OR
.venv\Scripts\activate # Windows
# Verify Python version
python --version # Should show Python 3.12.x🔑 API Key Management
Secure Storage
Never commit API keys to version control:
# Add to .gitignore
echo ".env" >> .gitignore
echo "*.key" >> .gitignore
echo "credentials/" >> .gitignoreEnvironment File Template
# Copy template
cp .env.example .env
# Edit with your keys
nano .envFirewall Configuration
Ensure these ports are accessible:
| Port | Service | Purpose |
|---|---|---|
| 8001 | API Registry | Tool registration |
| 8005 | CUGA Demo | Main application |
🐛 Troubleshooting
Common Environment Issues
| Issue | Solution |
|---|---|
| 🔴 Environment not active | Run source .venv/bin/activate |
| 🔴 API key not found | Check .env file and environment variables |
| 🔴 Port already in use | Stop conflicting services or change ports |
| 🔴 Permission denied | Check file permissions and ownership |
📚 Next Steps
After configuring your environment:
- Customization Overview: Fine-tune CUGA behavior
- API Integration: Add your own APIs
- Evaluation: Run benchmarks
Environment configured? Move to Customization Overview!