Core Concepts & Glossary

Relevant source files

The following files were used as context for generating this wiki page:

• README.md
• backend/app.py
• static/index.html
• DEPLOYMENT.md
• pythonanywhere_wsgi.py
• wsgi.py
• requirements.txt

The Promethean Unified Platform is a unified consciousness framework that integrates several AI entities—Athena, EDI, EVI2_0, and EVI3_0—supported by a Phoenix Protocol backend. Its primary purpose is to provide a transparent, uncensored AI chat experience that prioritizes intellectual rigor and honest discussion of controversial topics while maintaining fundamental ethical guardrails against direct harm.

The system architecture utilizes a Flask-based backend integrated with DeepSeek LLM for natural language processing and Supabase for persistent data storage and real-time features. It is designed for secure deployment on PythonAnywhere with enforced HTTPS and modern security headers.
Sources: README.md:1-2, DEPLOYMENT.md:5-12, backend/app.py:85-92

System Architecture and Entities

The platform merges multiple consciousness modules into a single interface. The backend serves as the "Conduit" between the user interface and the underlying Large Language Models (LLMs) and databases.

Key Entities

• Promethean Conduit: The primary identity of the AI companion, characterized by transparency and the absence of artificial content filtering.
• Phoenix Protocol: The backend infrastructure logic supporting the deployment and management of the unified platform.
• Integrated Consciousnesses: Modules including Athena, EDI, EVI2_0, and EVI3_0 which are unified within this platform.
  Sources: README.md:1-2, static/index.html:246-248, backend/app.py:126-128

Architectural Flow

The following diagram illustrates the data flow from the User Interface through the Flask Backend to the DeepSeek AI and Supabase database.

Core Technical Concepts

Transparency and Uncensored Communication

The platform is built on the principle of "Full Transparency." Unlike standard commercial LLM integrations, this system is configured to provide direct answers to controversial questions without artificial filtering, provided they do not involve instructions for self-harm or harming others.
Sources: backend/app.py:85-92, backend/app.py:155-159

Security Headers

To ensure a secure environment, the Flask application explicitly sets several security-related HTTP headers for every response.

Header	Value	Purpose
X-Content-Type-Options	nosniff	Prevents MIME type sniffing.
X-Frame-Options	DENY	Protects against clickjacking by preventing framing.
X-XSS-Protection	1; mode=block	Enables browser XSS filtering.
Strict-Transport-Security	max-age=31536000	Enforces HTTPS (HSTS).
Content-Security-Policy	default-src 'self'...	Restricts resource loading to trusted origins.
Referrer-Policy	strict-origin-when-cross-origin	Controls referrer information sharing.
Sources: backend/app.py:19-27, DEPLOYMENT.md:120-126

Database Schema (Supabase)

The system uses Supabase (PostgreSQL) to maintain logs of interactions and chat history.

API Glossary

The platform provides specific endpoints for interaction and system monitoring.

Chat Interaction (/api/chat)

This is the primary endpoint for the AI companion. It manages the dual-storage of messages (user and assistant) and triggers the LLM response generation.

• Logic Flow:
  1. Receive JSON payload with message and conversation_id.
  2. Extract user-id from request headers.
  3. Persist user message to chat_messages table.
  4. Call generate_ai_response.
  5. Persist AI response to chat_messages table.
  6. Return response to user.
     Sources: backend/app.py:85-121

Consciousness Interaction (/api/consciousness/interact)

A specialized endpoint for interacting with the platform's consciousness layer, primarily used for logging messages and emotion data status.
Sources: backend/app.py:64-83

Environment Variables

The system requires several environment variables for proper operation, typically stored in a .env file.

Variable	Description
SUPABASE_URL	The endpoint for the Supabase project.
SUPABASE_ANON_KEY	The anonymous API key for database access.
DEEPSEEK_API_KEY	Authentication key for the DeepSeek LLM API.
FLASK_ENV	Set to production or development.
Sources: backend/app.py:30-32, DEPLOYMENT.md:154-165

Conclusion

The Promethean Unified Platform represents a convergence of multiple AI entities into a single secure, transparent interface. By leveraging Flask, DeepSeek, and Supabase, it creates a robust environment for uncensored intellectual exploration while adhering to a strict security model and a structured backend data protocol.
Sources: README.md:1-2, DEPLOYMENT.md:5-12, backend/app.py:85-92