How joouha/euporie works
Main Components Identification
The system should be divided into these major components:
a. Core Applications:
• Console App
• Notebook App
• Preview App
• Hub App
b. Core Infrastructure:
• Kernel Management System
• Command & Control System
• UI/Layout Engine
• Conversion System
┌─ Applications Layer ─────────────────────────┐
• Console │ Notebook │ Preview │ Hub │
• ┴───────────┴───────────┴─────────┘
┌─ Core Services Layer ──────────────────────────────────────────┐
• ┌─ UI Components ─┐ ┌─ Kernel Interface ─┐ ┌─ Data Handling ─┐ │
• Widgets │ │ - Kernel Client │ │ - Converters │ │
• Layout │ │ - Kernel Manager │ │ - Formatters │ │
• Key Bindings│ │ - Comm System │ │ - IO Handlers │ │
• ┘ └──────────────────────┘ └────────────────┘ │
• ┘
┌─ Infrastructure Layer ───────────────────────────────────────┐
• Configuration │ Logging │ Terminal Interface │ File System │
• ┘
Implementation Details
a. Core Services:
• Command system (/core/commands.py)
• Key binding system (/core/key_binding/)
• Widget system (/core/widgets/)
• Conversion system (/core/convert/)
b. Application-Specific Components:
• Console-specific features
• Notebook editor capabilities
• Preview functionality
• Hub server components
External Integrations
Connections to:
• Jupyter kernels
• Terminal emulators
• File systems
• SSH for Hub functionality
Notes for Implementation
• Clear boundaries between applications
• Shared core functionality
• Version information and Python compatibility
Technical Details
• Support for multiple output formats (Sixel, iTerm, Kitty)
• Kernel communication protocols
• Widget interaction system
• Terminal rendering pipeline
• Nested components
• Custom styling
• Export to vector formats
• Easy updates for future modifications
Remember to maintain a balance between showing enough detail to understand the system's complexity while keeping it clear and readable.