Skip to content

Automatic model fallback system for nanobot AI - prevents downtime with proactive monitoring and cascading model switching

License

Notifications You must be signed in to change notification settings

capt-marbles/model-fallback-skill

Repository files navigation

["GitHub Release\nLicense\nPython\nStatus\n\nAutomatic model fallback and health monitoring for nanobot instances. Prevents downtime from model failures, API errors, or degraded performance.\n\n## Features\n\n- \u2728 Automatic Model Switching - Seamlessly fall back to backup models when primary fails\n- \ud83e\ude7a Health Monitoring - Proactive monitoring of response time, error rate, and timeout rate\n- \ud83d\udd00 Multi-Model Support - Configure cascading fallback chain with multiple providers\n- \ud83d\udcca Comprehensive Logging - Track all fallback events and health metrics\n- \ud83d\ude80 Easy Setup - One-command installation with dependency checks\n- \u26a1 Production Ready - Zero-downtime fallback with graceful degradation\n\n## Quick Start\n\nbash\n# Clone the repository\ncd ~/.nanobot/workspace/skills\ngit clone https://github.com/capt-marbles/model-fallback-skill.git\n\n# Run the installer\ncd model-fallback-skill\n./install.sh\n\n# Start the health check monitor\npython3 scripts/health-check.py start\n\n\n## Installation\n\n### Prerequisites\n\n- Python 3.8 or higher\n- nanobot installed and configured\n- At least two model providers configured (Minimax, OpenRouter, etc.)\n\n### Step-by-Step Installation\n\n1. Clone the repository:\n bash\n cd ~/.nanobot/workspace/skills\n git clone https://github.com/capt-marbles/model-fallback-skill.git\n \n\n2. Run the installer:\n bash\n cd model-fallback-skill\n ./install.sh\n \n\n3. Configure fallback models in your nanobot config:\n ```json\n {\n "agents": {\n "defaults": {\n "model": "minimax/m2.5", "fallbackModels": [\n "openrouter/anthropic/claude-3.5-sonnet", "openrouter/glm-4.7"], {"agents": {"defaults": {"model": "minimax/m2.5", "fallbackModels": ["openrouter/anthropic/claude-3.5-sonnet", "openrouter/glm-4.7", "openrouter/google/gemini-2.0-flash-exp:free"]}}}, "TROUBLESHOOTING.md.\n\n## Documentation\n\n- API Documentation - Script API reference\n- Architecture - System design and components\n- Contributing - How to contribute\n- Changelog - Version history\n\n## Contributing\n\nWe welcome contributions! Please see CONTRIBUTING.md for guidelines.\n\n## License\n\nThis project is licensed under the MIT License - see the LICENSE file for details.\n\n## Acknowledgments\n\n- Built for the nanobot community\n- Inspired by production reliability needs\n\n## Support\n\n- \ud83d\udcd6 Documentation\n- \ud83d\udc1b Issue Tracker\n- \ud83d\udcac Discussions\n\n---\n\nMade with \u2764\ufe0f for the nanobot community"]]

About

Automatic model fallback system for nanobot AI - prevents downtime with proactive monitoring and cascading model switching

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Packages

No packages published