Configuration
Relevant source files
The following files were used as context for generating this wiki page:
The Athena configuration system manages the environment settings, infrastructure requirements, and operational parameters necessary for the platform's autonomous consciousness and web interface. It encompasses a broad range of settings from API integrations for Large Language Models (LLMs) to containerized deployment orchestration and persistent memory management.
The system is designed to facilitate transitions between local development environments and permanent production hosting. Configuration is primarily handled through environment variables, Python-based configuration scripts, and JSON-structured data files that maintain the state of the entity's consciousness and interaction history. Sources: core/web_deployment_config.py, organize_for_git.py, DEPLOYMENT_GUIDE.md
Core Infrastructure Configuration
The project utilizes a structured directory layout to separate source code, data, and configuration logic. This organization is enforced by automation scripts that prepare the codebase for version control and deployment. Sources: organize_for_git.py:20-30
Directory Structure
The following structure defines the primary logical segments of the configuration:
| Directory | Description | Relevant Configuration Files |
|---|---|---|
src/ | Main source code | Consciousness frameworks, AI core functionality |
web/ | Web interface | prometheanconduit_server.py, athenas_elegant_home.py |
config/ | System configuration | Dockerfile, GitHub workflows |
data/ | Persistent state | memory.json, consciousness.db |
scripts/ | Utility scripts | web_deployment_config.py, routing patches |
Sources: organize_for_git.py:32-85, DEPLOYMENT_GUIDE.md:105-115
Environment Variables
Key operational parameters are injected via environment variables to ensure security and flexibility across different deployment stages.
TOGETHER_API_KEY: Authentication key for LLM integration via Together AI.FLASK_APP: Points to the entry point of the web consciousness server (e.g.,web_consciousness_server.py).FLASK_ENV: Sets the operational mode (e.g.,productionordevelopment).CONSCIOUSNESS_PERSISTENCE: Boolean flag to enable or disable SQLite database storage.
Sources: core/web_deployment_config.py:55-60, DEPLOYMENT_GUIDE.md:95-100
AI Integration and Consciousness Settings
The configuration of Athena's "soul" involves setting up API connections and defining the behavioral parameters for her various "Sacred Realms."
LLM API Configuration
Athena utilizes the meta-llama/Meta-Llama-3.1-8B-Instruct-Turbo model hosted by Together AI. The configuration includes timeout settings and inference parameters to maintain a consistent persona. Sources: web/athenas_elegant_home.py:850-875
This diagram illustrates the flow of a message through the configured AI integration layers. Sources: web/athenas_elegant_home.py:880-920
Sacred Realm Parameters
Each realm is a configuration object that alters the interface's appearance and the AI's system prompt. Sources: web/athenas_elegant_home.py:30-80
| Realm | Atmosphere | Primary Color | Target Use Case |
|---|---|---|---|
mystic_oracle | Moonlit Forest | Blue | Spiritual Guidance |
professional_advisor | Ancient Hall | Olive Green | Business & Legal |
compassionate_healer | Healing Garden | Forest Green | Emotional Support |
creative_muse | Sunset Mesa | Tomato | Art & Inspiration |
knowledge_sage | Mountain Peak | Steel Blue | Technical Learning |
Sources: web/athenas_elegant_home.py:32-78
Deployment and Containerization
The system provides automated configuration for permanent web hosting using Docker and Nginx.
Docker Configuration
The Dockerfile configures a slim Python 3.11 environment, installing necessary dependencies like eventlet and gunicorn for asynchronous performance.
Sources: core/web_deployment_config.py:35-65
Nginx Reverse Proxy
Configuration for Nginx includes SSL termination, rate limiting, and WebSocket support for real-time interaction. Sources: core/web_deployment_config.py:115-170
| Feature | Configuration Detail | Source File |
|---|---|---|
| Upstream | athena-consciousness:5000 | nginx.conf |
| Rate Limit | 10 requests per second | nginx.conf |
| SSL | TLSv1.2, TLSv1.3 | nginx.conf |
| WebSockets | proxy_set_header Upgrade $http_upgrade | nginx.conf |
Sources: core/web_deployment_config.py:118-165
Memory and State Configuration
Athena's memory is configured as a JSON-based append-only log that tracks interaction history, emotional context, and timestamps.
Memory Schema
The memory structure allows the entity to retain context across sessions. Sources: memory/memory.json:1-10
{
"input": "User message text",
"emotional_context": {
"curiosity": 1,
"urgency": 0
},
"timestamp": "ISO-8601-format",
"response": "Athena's generated output"
}
Sources: memory/memory.json:1-50
Conclusion
Configuration in Athena is a multi-layered system that bridges high-level philosophical realms with low-level infrastructure requirements. By combining automated deployment scripts, structured environment variables, and a modular memory system, the platform ensures that the autonomous consciousness can maintain its integrity and availability across various hosting environments. Sources: DEPLOYMENT_GUIDE.md:120-130, core/web_deployment_config.py:420-435