Releases: YenFreya/Odysseus-AI-Control-Center
v1.4.0 "Mnemosyne" — Stable Release
Stable Release
Mnemosyne is the latest stable release of Odysseus AI Control Center.
This release builds upon the reliability of Athena while simplifying the architecture even further. The experimental watchdog subsystem has been completely removed and replaced with a more predictable startup validation workflow and manual recovery controls.
Mnemosyne focuses on stability, transparency, and maintainability while preserving the one-click experience for managing local Odysseus environments.
🟢 Release Status
Current Stable Release
Mnemosyne is intended to serve as the long-term stable branch of Odysseus AI Control Center.
Development philosophy:
- Simpler is better
- Explicit failures are better than hidden recovery
- Manual control is preferred over aggressive automation
- Clear logging is preferred over silent behavior
✨ What's New in Mnemosyne
✅ Startup Validation System
Before declaring startup successful, Mnemosyne now performs a final validation phase.
The system verifies:
- Docker Engine is responding
- Ollama API is reachable
- Odysseus Web UI is reachable
- Required services are operational
If validation fails:
- Failure is logged
- User receives a clear error message
- Startup aborts safely
- Partial startup states are cleaned up
🔄 Restart Odysseus Feature
New main menu option:
[6] Restart Odysseus
Restart performs:
- Safe shutdown sequence
- Docker shutdown
- WSL shutdown
- Cooldown delay
- Clean startup sequence
- Startup validation
This provides a predictable recovery workflow without requiring users to close and reopen the control center.
📋 Improved Logging
Mnemosyne improves visibility when startup failures occur.
Instead of background recovery attempts:
- Errors are written directly to logs
- Failures are visible immediately
- Users can diagnose problems more easily
❌ Removed in Mnemosyne
Watchdog System Removed
The entire watchdog subsystem has been removed.
Removed components:
- Watchdog background process
- watchdog.pid
- .watchdog_enabled
- Watchdog startup interception
- Watchdog monitoring loop
- Watchdog restart automation
- Watchdog configuration menu
- Watchdog status display
- Watchdog deduplication logic
- Watchdog crash recovery state machine
Why it was removed
During testing the watchdog introduced:
- PID tracking complexity
- Background process synchronization issues
- Duplicate watchdog launch scenarios
- Difficult debugging behavior
- Increased maintenance burden
The watchdog solved a rare problem while introducing significant complexity.
Mnemosyne replaces this with:
- Startup validation
- Manual restart controls
- Clear logging
- Simpler architecture
Result:
- Less code
- Fewer edge cases
- Easier maintenance
- More predictable behavior
📸 Main Features
🧠 Environment Detection
Automatically validates:
- Docker Desktop
- Docker CLI
- Ollama
- WSL
- curl
before allowing service operations.
🚀 Service Startup
One-click startup for:
- Docker Desktop
- Ollama
- Odysseus Container
with readiness checks and validation.
🛑 Service Shutdown
Controlled shutdown of:
- Odysseus
- Ollama
- Docker Desktop
- WSL
to reduce stale state issues.
🔄 Service Restart
Dedicated restart workflow for:
- Docker
- WSL
- Ollama
- Odysseus
without exiting the control center.
📦 Model Management
Displays:
- Installed Ollama models
- Storage usage
- Model inventory
for quick environment inspection.
📊 Health Monitoring
Health Check provides:
- Odysseus status
- Ollama status
- Docker status
- Storage statistics
- Data-path validation
📜 Log Management
Built-in tools for:
- Viewing logs
- Viewing crash logs
- Clearing logs
to simplify troubleshooting.
🔄 Project Evolution
🔥 v1.0.0 "Genesis"
Original proof-of-concept release.
Introduced:
- Core startup workflow
- Service management
- Initial monitoring systems
Limitations included:
- Heavy output suppression
- Fixed-delay startup logic
- Limited diagnostics
- Early watchdog implementation
☀️ v1.2.0 "Icarus"
Large experimental rewrite.
Added:
- PowerShell helpers
- Backup workflows
- Update systems
- Advanced automation
- Recovery features
While powerful, Icarus became increasingly complex.
🦉 v1.3.1 "Athena"
Return-to-stability release.
Focused on:
- Simplicity
- Reliability
- Reduced automation
- Easier maintenance
Athena became the stable baseline.
🧠 v1.4.0 "Mnemosyne"
Refines Athena's philosophy even further.
Added
- Startup Validation System
- Restart Odysseus menu option
- WSL shutdown during restart
- Improved startup diagnostics
- Clearer failure handling
Removed
- Entire watchdog subsystem
- Background monitoring process
- PID tracking files
- Automatic crash recovery
- Watchdog settings
- Watchdog health display
Improved
- Startup reliability
- Recovery workflow
- Log transparency
- Maintainability
- Code simplicity
📋 Requirements
Required
- Windows 10 or Windows 11
- Docker Desktop
- Ollama
- Odysseus
Recommended
- WSL 2 enabled
- Administrative privileges for certain operations
🤖 AI-Assisted Development Disclosure
This project was created as a learning project using AI-assisted development tools.
Estimated AI contribution:
80–95%
The developer provided:
- Direction
- Testing
- Validation
- Integration
- Final design decisions
⚠️ Testing Notice
This project has been tested primarily on the developer's personal system.
Although Mnemosyne has been stable during development, it has not been extensively tested on other hardware or Windows configurations. Compatibility with all environments cannot be guaranteed.
Please report any bugs or compatibility issues through GitHub Issues.
👨💻 Author
Created and maintained by Yen The Programmer
Learning software development through experimentation, self-hosting, open-source projects, and AI-assisted workflows.
📌 License
MIT License
You are free to:
- Use
- Modify
- Fork
- Redistribute
- Reuse in personal or commercial projects
at your own discretion.
Odysseus AI Control Center v1.3.1 — Athena
🚀 Odysseus AI Control Center v1.3.1 "Athena"
🟢 Stable Release
Athena is the latest stable release of Odysseus AI Control Center.
This version focuses on simplicity, reliability, and ease of use for managing local Odysseus environments. Compared to previous experimental releases, Athena removes much of the complex automation and focuses on core functionality that has proven stable during real-world use on the developer's system.
This is the version showcased below and represents the current stable feature set.
⚠️ Maintenance Status
- This project is currently in a maintenance-only state
- No major feature development is planned
- Updates will only be released if bugs, compatibility issues, or critical problems are reported
- This version serves as the stable baseline release of the project
📸 Screenshots
🧠 Environment Detection & Validation
Automatically verifies Docker Desktop, Docker CLI, Ollama, WSL, and curl availability during startup.
🖥️ Main Dashboard
View system status, installed models, logs, and service controls in one place.
🚀 Starting AI Services
Starts Docker, Ollama, and Odysseus with automated readiness checks.
🛑 Stopping AI Services
Stops running services safely and performs controlled shutdown operations.
📦 Installed AI Models
Displays locally installed Ollama models and related information.
📊 System Health Check
Displays service status, storage information, and watchdog state.
📜 Log Viewer
Provides access to application and system logs for monitoring and troubleshooting.
⚙️ Settings
Configure watchdog mode, data path settings, and utility options.
✨ Features
🔍 Environment Validation
- Docker Desktop detection
- Docker CLI validation
- Ollama detection
- WSL detection
- Curl verification
- Startup readiness checks
- Diagnostic reporting
🚀 Service Management
- One-click Odysseus startup
- Automatic Docker startup
- Automatic Ollama startup
- Startup readiness validation
- Service status monitoring
- Graceful shutdown controls
📊 Monitoring & Diagnostics
- Installed Ollama model detection
- Storage usage reporting
- Health status monitoring
- Log viewing and management
- Watchdog monitoring mode
- Environment diagnostics
⚙️ Configuration
- Watchdog configuration
- Data-path configuration
- Quick-access folder shortcuts
- Basic environment preferences
🔄 Evolution of the Project
Odysseus AI Control Center has gone through multiple iterations.
🔥 v1.0.0 "Genesis"
The original proof-of-concept release.
While functional, Genesis contained several design decisions that were later criticized and improved:
- Embedded PowerShell scripts encoded directly inside the batch file
- Limited error handling and visibility
- Heavy output suppression (
>nul 2>&1) - Aggressive file deletion methods
- Full-drive scanning for path detection
- Reliance on fixed delay timers
- Early watchdog implementation with limited safeguards
Community feedback and developer reviews highlighted concerns regarding maintainability, transparency, and safety.
☀️ v1.2.0 "Icarus"
A large experimental rewrite.
Introduced:
- External PowerShell helper scripts
- Backup and restore workflows
- SHA256 verification
- Watchdog improvements
- Advanced automation
- Update management systems
- Data path detection improvements
Although significantly more advanced than Genesis, Icarus also introduced additional complexity and aggressive recovery behaviors that were not ideal for every environment.
🦉 v1.3.1 "Athena"
Athena represents a return to simplicity.
Removed from earlier versions
- Backup systems
- Restore workflows
- Auto-update systems
- Aggressive recovery automation
- Excessive startup complexity
- Experimental orchestration features
Improved
- Simpler codebase
- Easier maintenance
- Reduced operational risk
- Cleaner startup workflow
- More predictable behavior
- Better focus on everyday usage
- More transparent functionality
Athena serves as the stable baseline release moving forward.
📋 Requirements
Required
- Windows 10 or Windows 11
- Docker Desktop
- Ollama
- Odysseus
Recommended
- WSL 2 enabled
- Administrative privileges for certain system operations
📚 Installation
- Install Docker Desktop
- Install Ollama
- Install and configure Odysseus
- Download the latest Athena release
- Extract the archive
- Run:
Odysseus AI Control Center.bat- Follow on-screen instructions
📖 Installation Reference
📺 https://youtu.be/qiy-oPT8IhE
This guide was used during setup and development and served as the original installation reference for Odysseus and its dependencies.
Always refer to official Odysseus documentation for the latest installation and configuration information.
🤖 AI-Assisted Development Disclosure
This project was created primarily as a learning project using AI-assisted development tools.
- A significant portion of the codebase, logic, and documentation was generated or refined using AI systems
- The developer provided direction, testing, integration, review, and final decisions
- Development followed an iterative AI-assisted workflow
Estimated AI contribution: ~80–95%
This disclosure is provided for transparency.
⚠️ Disclaimer
Odysseus AI Control Center is provided "as is" without warranties or guarantees of any kind.
This software:
- Has been tested primarily on the developer's personal system
- May behave differently on other hardware or Windows configurations
- May not work correctly in every environment
- Is currently in a maintenance-only state
- Will only receive updates if bugs or compatibility issues are reported
Users are responsible for:
- Reviewing the source code before execution
- Verifying compatibility with their environment
- Managing their own backups
- Understanding the actions performed by the software
The author is not responsible for:
- Data loss
- Configuration issues
- Service interruptions
- Software conflicts
- Hardware problems
- Any direct or indirect damages resulting from use of this software
Use entirely at your own risk.
🤝 Contributions
Contributions are welcome.
You are free to:
- Fork the project
- Modify the source code
- Improve existing functionality
- Fix bugs
- Adapt it for your own workflows
- Learn from the implementation
Pull requests and improvements are encouraged.
👨💻 Author
Created and maintained by Yen The Programmer
Beginner developer learning software development through experimentation, open-source projects, and AI-assisted workflows.
📌 License
MIT License
You are free to:
- Use
- Modify
- Fork
- Redistribute
- Reuse in personal or commercial projects
As long as attribution and license notices are preserved.
Odysseus AI Control Center v1.2.0 — Icarus Release
🚀 Odysseus AI Control Center — v1.2.0 "Icarus"
⚠️ EXPERIMENTAL / UNSTABLE RELEASE
READ BEFORE DOWNLOADING
This release is an experimental version of the Odysseus AI Control Center intended for testing, learning, and development purposes.
Compared to v1.0.0 "Genesis", this version introduces significantly more automation, service orchestration, backup tooling, watchdog monitoring, and environment detection features.
Because of its aggressive automation and system-level operations, this version should NOT be considered production-ready.
📁 REQUIRED FOLDER STRUCTURE
The batch file and PowerShell scripts must remain together.
Odysseus AI Control Center V1.2.0
│
├── Odysseus_AI_Control_Center_v1_2_0_Icarus.bat
│
└── scripts
├── ody_backup.ps1
├── ody_verify.ps1
└── ody_restore.ps1
⚠️ IMPORTANT
The scripts folder is REQUIRED.
If the following files are missing:
- ody_backup.ps1
- ody_verify.ps1
- ody_restore.ps1
then backup, verification, restore, and related features will not function correctly.
✨ MAIN FEATURES
🔍 Environment Detection
- Docker Desktop detection
- Docker Engine validation
- Ollama installation checks
- WSL detection
- Curl verification
- Startup readiness checks
- Diagnostic reporting
🚀 Service Management
- One-click Odysseus startup
- Docker auto-start
- Ollama auto-start
- Service status monitoring
- Startup retry logic
- Service shutdown controls
📊 Monitoring & Diagnostics
- Installed Ollama model detection
- Storage usage reporting
- System status checks
- Log viewing
- Watchdog monitoring
💾 Backup & Restore
- Backup creation
- SHA256 integrity verification
- Backup validation
- Restore operations
- Recovery workflows
⚠️ RISK WARNINGS
This version performs system-level operations that may affect Docker, WSL, and running services.
Potential risks include:
- WSL shutdown operations
- Docker restarts
- Automatic service recovery attempts
- Data overwrite during restore operations
- Different behavior across Windows configurations
Always review the source code before execution.
Always maintain backups of important data.
Use caution when testing restore or recovery functions.
🧪 INTENDED USE
This release is intended for:
- Learning
- Code review
- Development environments
- Testing
- Experimentation
It is NOT recommended for production deployments.
📖 REFERENCE
Guide used during setup and development:
Refer to official Odysseus documentation for the latest installation and configuration information.
👨💻 AUTHOR
Created and maintained by Yen The Programmer
📌 LICENSE
MIT License
Free to use, modify, redistribute, fork, and improve with proper attribution.
⚠️ FINAL NOTE
v1.2.0 "Icarus" is preserved as a historical experimental release.
It introduced many automation concepts later refined in newer versions, but it may contain bugs, unfinished behavior, or implementation decisions that would not be used in later releases.
Use for learning, reference, testing, and experimentation at your own risk.
Odysseus AI Control Center v1.0.0 — Genesis Release
⚠️ IMPORTANT NOTICE
🚨 THIS IS AN OLD AND EXPERIMENTAL VERSION
🚨 DO NOT USE FOR DAILY OR PRODUCTION USE
🚨 THIS VERSION IS FOR CODE STUDY ONLY
This release is kept strictly for:
- Learning purposes
- Code reference
- Development history review
It may contain unstable, incomplete, or unsafe automation logic.
📌 Overview
Odysseus AI Control Center v1.0.0 (Genesis) is the first public foundation release of the project.
It introduces a Windows-based control interface designed to simplify the setup and management of local Odysseus environments using Docker and Ollama.
🎯 Purpose of Genesis
This version was created to reduce manual setup complexity by combining system checks, service startup, and basic monitoring into one interface.
It represents the starting point of the Odysseus Control Center project.
✨ Features (Early Prototype Stage)
🔍 Environment Detection
- Docker Desktop detection
- Docker Engine validation
- Ollama detection
- WSL availability checks
- Curl/system tool verification
- Basic system readiness checks
🚀 Service Startup
- One-click startup for Odysseus environment
- Docker and Ollama initialization
- Basic startup sequence automation
📊 Basic Monitoring
- Simple system status checks
- Early logging output
- Initial diagnostics support
⚠️ Known Risks & Limitations
This version is NOT SAFE for general use.
It may include:
- Experimental or unstable scripts
- Incomplete error handling
- Forced system operations
- Delayed or unreliable startup logic
- Lack of safety checks in automation flows
🧠 External Review Notes
Community feedback on this version highlighted:
- Overly aggressive automation in some system operations
- Limited error handling and debugging visibility
- Heavy reliance on fixed delays instead of real-time checks
- Risky system-level commands in certain workflows
- Early-stage architecture not optimized for stability
This feedback is part of the project's learning and evolution process.
📚 Installation Reference
This project was originally developed using the following guide:
📺 https://youtu.be/qiy-oPT8IhE
Used for setting up Docker, Ollama, and base environment dependencies.
Always refer to official Odysseus documentation for current setup instructions.
⚠️ FINAL WARNING
🚫 DO NOT RUN THIS VERSION UNLESS YOU ARE STUDYING THE CODE
🚫 DO NOT USE FOR ACTIVE SYSTEM DEPLOYMENT
🚫 DO NOT RELY ON THIS VERSION FOR STABILITY
Use only for:
✔ Reading source code
✔ Understanding early design
✔ Learning project evolution
👨💻 Author
Created and maintained by Yen The Programmer
📌 License
MIT License applies — free to use, modify, and study with attribution.