🌙 Hypnos is a daemonized workflow automation system that transforms your vague ideas into complete projects using AI-powered generation. Control everything through Telegram bot with secure workspace isolation and AI persona collaboration.
- 🤖 AI-Powered Project Generation - Transform vague ideas into complete projects
- 📱 Telegram Bot Control - Manage workflows from anywhere via Telegram
- 🎭 AI Personas & Teams - Work with AI personalities (Alex, Sarah, Marcus, etc.)
- 🔒 Security-First Design - Complete workspace isolation with path traversal protection
- 👥 Multi-User Support - User-based access control and workspace management
- 🤖 Multi-LLM Support - Claude, Zlaude, GPT-4, and local models
- 🏗️ Intelligent Architecture - Natural language to complete project generation
graph TB
%% User Interface Layer
User[👤 User] --> Telegram[📱 Telegram Bot]
%% Command Processing
Telegram --> CommandHandler[🎮 Command Handler]
%% Authentication & Security
CommandHandler --> Auth[🔐 Authentication Layer]
Auth --> |User ID Validation| UserContext[👥 User Context]
%% Core Management Systems
CommandHandler --> WorkspaceManager[📂 Workspace Manager]
CommandHandler --> PersonaManager[🎭 Persona Manager]
CommandHandler --> LLMManager[🤖 LLM Manager]
%% Workspace System
WorkspaceManager --> WorkspaceContext[🏗️ Workspace Context]
WorkspaceManager --> IsolatedStorage[📁 Isolated Storage<br/>~/.hypnos/workspaces/]
%% Security Features
IsolatedStorage --> PathTraversal[🛡️ Path Traversal Protection]
IsolatedStorage --> FileTypeFilter[📋 File Type Filtering]
IsolatedStorage --> UserIsolation[🔒 User-based Isolation]
%% Persona System
PersonaManager --> Personas[🎭 Global Personas<br/>Alex, Sarah, Marcus, Evelyn, Jamie]
PersonaManager --> Teams[👥 Teams<br/>Full-Stack, Mobile, Enterprise]
PersonaManager --> PersonaStorage[💾 Persona Config<br/>~/.hypnos/personas.json]
%% AI/LLM Integration
LLMManager --> Providers[🔌 LLM Providers<br/>Claude, Zlaude, GPT-4, Local Models]
LLMManager --> CostOptimization[💰 Cost Optimization]
LLMManager --> Failover[🔄 Failover System]
%% Project Generation Workflow
CommandHandler --> WorkspaceGenerator[🏗️ Workspace Generator]
WorkspaceGenerator --> ProjectSpec[📋 Project Specification]
WorkspaceGenerator --> CodeGeneration[💻 Code Generation]
WorkspaceGenerator --> DependencySetup[📦 Dependency Setup]
%% AI Integration in Generation
ProjectSpec --> LLMManager
CodeGeneration --> PersonaPrompts[🎭 Persona System Prompts]
PersonaPrompts --> LLMManager
%% Output & Storage
CodeGeneration --> GeneratedFiles[📁 Generated Project Files]
GeneratedFiles --> ProjectStructure[🏗️ Project Structure]
ProjectStructure --> Documentation[📚 Documentation]
%% State Management
UserContext --> WorkspaceContext
PersonaManager --> ProjectGenerationContext[🎯 Generation Context]
%% Styling
classDef userLayer fill:#e1f5fe
classDef securityLayer fill:#fff3e0
classDef coreLayer fill:#f3e5f5
classDef aiLayer fill:#e8f5e8
classDef storageLayer fill:#fce4ec
class User,Telegram userLayer
class Auth,PathTraversal,FileTypeFilter,UserIsolation securityLayer
class WorkspaceManager,PersonaManager,LLMManager,WorkspaceGenerator coreLayer
class LLMManager,Providers,CostOptimization,Failover,PersonaPrompts aiLayer
class IsolatedStorage,PersonaStorage,GeneratedFiles storageLayer
- Node.js 18+
- npm or yarn
- Telegram Bot Token
git clone https://github.com/karolswdev/hypnos.git
cd hypnos
npm install- Create a Telegram bot via @BotFather
- Set environment variables:
export HYPNOS_BOT_TOKEN="your_bot_token_here"
export HYPNOS_ADMIN_USER_ID="your_telegram_user_id"npm run hypnos:test/start- Welcome message and status/help- Show all available commands/status- Check daemon status/ping- Test bot response time
/ws- Show workspace overview/ws use <workspace>- Switch active workspace/ws create <name>- Create new workspace/ws delete <workspace>- Delete workspace
/personas- Show available AI personas/persona use <name>- Set active persona/teams- Show available teams/team use <name>- Set active team
/create "project idea"- Create project from vague idea/enhance <workspace> <feature>- Add features to existing project
- 🧑💻 Alex Chen - Senior Full-Stack Developer (React, TypeScript, Node.js)
- 🎨 Sarah Miller - UI/UX Designer (Figma, CSS, Accessibility)
- ⚙️ Marcus Johnson - DevOps Engineer (Docker, CI/CD, AWS)
- 🏗️ Dr. Evelyn Reed - System Architect (Microservices, Security)
- 📱 Jamie Park - Mobile Developer (React Native, iOS, Android)
- Complete workspace isolation in
~/.hypnos/workspaces/ - Path traversal protection and file type filtering
- User-based authentication via Telegram user IDs
- Secure AI provider integration
Hypnos integrates with multiple LLM providers:
- Claude (Anthropic) - Advanced reasoning and code generation
- Zlaude - Specialized development tasks
- GPT-4 (OpenAI) - Versatile general-purpose AI
- Local Models - Privacy-focused offline generation
hypnos/
├── src/
│ ├── hypnos/
│ │ ├── core/ # Core management systems
│ │ ├── integrations/ # External integrations
│ │ └── utils/ # Utility functions
│ └── cli/ # CLI interface
├── docs/ # Documentation
└── templates/ # Project templates
Phase 1 - Complete ✅
- ✅ Telegram bot integration
- ✅ Secure workspace management
- ✅ Persona & team system
- ✅ Multi-user support
Phase 2 - In Progress 🚧
- 🚧 AI-powered project generation
- 🚧 Multi-LLM integration
- 🚧 Intelligent code generation
Contributions are welcome! Please read our contributing guidelines and submit pull requests.
This project is licensed under the MIT License - see the LICENSE file for details.
Built with ❤️ using:
- node-telegram-bot-api
- TypeScript
- The open-source community
🌙 Hypnos - Transform your ideas into reality, one command at a time.