Skip to main content

Recent Releases

v0.1.4.post3 (2026-02-28)

🧹 Cleaner Context, Hardened Sessions, Smarter Agent Changes:
  • Cleaner context: Improved prompt building
  • Hardened session history: More reliable conversation tracking
  • Smarter agent: Better decision-making
  • Security improvements
  • Bug fixes and stability improvements
Release notes

v0.1.4.post2 (2026-02-24)

🛡️ Reliability-Focused Release Features:
  • Redesigned heartbeat system: More reliable periodic task execution
  • Prompt cache optimization: Faster responses with caching
  • Hardened provider stability: Better error handling
  • Hardened channel stability: Improved connection resilience
Improvements:
  • Virtual tool-call heartbeat
  • Slack mrkdwn formatting fixes
  • Discord typing indicator fixes
Release notes

v0.1.4.post1 (2026-02-21)

🎉 Major Feature Release New Providers:
  • VolcEngine support
  • MCP custom auth headers
  • Anthropic prompt caching
Media Support:
  • Feishu multimodal file handling
  • Slack file sending
  • Discord long message splitting
Improvements:
  • More reliable memory subsystem
  • Subagents work in CLI mode
  • Session poisoning fix
  • WhatsApp deduplication
  • Windows path compatibility
  • Mistral provider compatibility
Release notes

v0.1.4 (2026-02-17)

🎉 MCP Support, Progress Streaming, New Providers Major Features:
  • MCP integration: Model Context Protocol support
  • Progress streaming: Real-time updates during agent execution
  • New providers: Multiple new LLM provider integrations
  • Channel improvements: Better stability across all channels
New Features:
  • ClawHub skill search and install
  • OpenAI Codex provider with OAuth
  • MiniMax support
Improvements:
  • Enhanced CLI experience
  • Better session management
  • Auto workspace template sync
Release notes

v0.1.3.post7 (2026-02-13)

🔒 Security Hardening Release Security:
  • Security hardening across all components
  • Important: Upgrade recommended to address security issues
Improvements:
  • Redesigned memory system: Less code, more reliable
  • Better error handling
  • Stability improvements
Release notes

v0.1.3.post6 (2026-02-10)

✨ Enhancements and Fixes New Features:
  • Slack support
  • Email channel support
  • QQ channel support
Improvements:
  • Enhanced CLI experience
  • Better provider detection
  • Improved error messages
Release notes

v0.1.3.post5 (2026-02-07)

🚀 Qwen Support & Key Improvements New Features:
  • Qwen/DashScope provider support
  • Refactored provider system: 2-step provider addition
Improvements:
  • Better provider registry
  • Simplified provider configuration
  • Improved documentation
Release notes

v0.1.3.post4 (2026-02-04)

🐳 Multi-Provider & Docker Support New Features:
  • Multi-provider support: Switch between LLMs easily
  • Docker support: Containerized deployment
  • DeepSeek provider
  • Moonshot/Kimi provider
  • Discord channel integration
Improvements:
  • Enhanced security hardening
  • Better configuration validation
Release notes

Earlier Releases

v0.1.3 Series

Focus: Multi-channel support, provider flexibility, security hardening. Key milestones:
  • Added 10 chat channels (Telegram, Discord, WhatsApp, etc.)
  • Implemented provider registry pattern
  • Enhanced security features
  • Docker support
  • MCP integration

v0.1.2 Series

Focus: Core agent stability, tool improvements. Key milestones:
  • Stable agent loop
  • Multiple built-in tools
  • Session management
  • Memory system

v0.1.1 Series

Focus: Basic functionality, initial channels. Key milestones:
  • Telegram channel
  • Basic tool set (shell, filesystem, web)
  • Configuration system

v0.1.0 (2026-02-02)

🎉 Initial Release Features:
  • Core agent loop
  • Telegram channel
  • Basic tools (exec, read, write, web_search)
  • OpenRouter provider
  • CLI interface
  • Configuration via config.json

Version History Summary

VersionDateHighlights
v0.1.4.post32026-02-28Cleaner context, hardened sessions
v0.1.4.post22026-02-24Reliability focus, heartbeat redesign
v0.1.4.post12026-02-21New providers, media support
v0.1.42026-02-17MCP support, progress streaming
v0.1.3.post72026-02-13Security hardening
v0.1.3.post62026-02-10Slack, Email, QQ channels
v0.1.3.post52026-02-07Qwen support, provider refactor
v0.1.3.post42026-02-04Multi-provider, Docker
v0.1.02026-02-02Initial release

Breaking Changes

v0.1.4.post3

Access Control Change:
  • Before: Empty allowFrom = allow all senders
  • After: Empty allowFrom = deny all senders (use ["*"] for allow-all)
  • Migration: Add "allowFrom": ["*"] to channel configs if you want to allow all users

v0.1.3.post7

Memory System Redesign:
  • Old memory format no longer supported
  • Migration: Manually copy important facts to new MEMORY.md format

Upgrade Guide

From v0.1.4.postX to latest

No breaking changes. Just upgrade:
pip install --upgrade nanobot-ai

From v0.1.3.x to v0.1.4.x

Changes:
  • MCP server config format (compatible, no action needed)
  • Progress streaming metadata (internal, no action needed)
Steps:
  1. Upgrade: pip install --upgrade nanobot-ai
  2. Test: nanobot agent -m "Hello"

From v0.1.2.x to v0.1.3.x

Changes:
  • Provider registry pattern (config format unchanged)
  • Memory system redesigned
Steps:
  1. Backup config: cp ~/.nanobot/config.json ~/.nanobot/config.json.backup
  2. Upgrade: pip install --upgrade nanobot-ai
  3. Migrate memory: Review ~/.nanobot/workspace/MEMORY.md
  4. Test: nanobot agent -m "Hello"

Deprecation Notices

Current

No deprecated features.

Future

v0.2.0 (planned):
  • Old config format (pre-v0.1.3) will no longer be supported
  • Migration tool will be provided

Download Statistics

See PyPI downloads for latest stats. Current (as of v0.1.4.post3): Growing rapidly!

Contributing to Releases

Release Process

  1. Version bump: Update version in pyproject.toml
  2. Changelog: Update CHANGELOG.md (if exists)
  3. Tag: Create git tag git tag v0.1.x
  4. Build: python -m build
  5. Publish: twine upload dist/*
  6. GitHub Release: Create release with notes

Semantic Versioning

We follow semantic versioning (roughly):
  • Major (v1.0.0): Breaking changes, major rewrites
  • Minor (v0.2.0): New features, non-breaking changes
  • Patch (v0.1.5): Bug fixes, minor improvements
  • Post (v0.1.4.post1): Hotfixes, urgent patches

Release Notes Guidelines

When creating release notes:
  1. Title: Short, descriptive (e.g., “MCP Support & Progress Streaming”)
  2. Summary: 2-3 sentences explaining the release
  3. Sections:
    • New Features: What’s new
    • Improvements: What’s better
    • Bug Fixes: What’s fixed
    • Breaking Changes: What breaks (if any)
  4. Credits: Thank contributors
  5. Links: Link to PRs, issues, discussions

Stay Updated


Frequently Asked Questions

How often are releases?

  • Patch releases: As needed (bug fixes)
  • Minor releases: Every 1-2 weeks (new features)
  • Major releases: When breaking changes occur

Should I always upgrade?

  • Security releases: Yes, immediately
  • Feature releases: When you need the features
  • Patch releases: Recommended (usually safe)

How do I rollback?

pip install nanobot-ai==0.1.4.post2  # Specific version

What if an upgrade breaks my setup?

  1. Rollback to previous version
  2. Check changelog for breaking changes
  3. Open a GitHub issue with details
  4. We’ll help you migrate or fix the issue

Version Support

Currently Supported

  • v0.1.4.x: Active development, bug fixes
  • v0.1.3.x: Security fixes only

End of Life

  • v0.1.2.x: No longer supported
  • v0.1.1.x: No longer supported
  • v0.1.0: No longer supported

Long-Term Support (Future)

When v1.0 is released, we’ll establish LTS versions:
  • LTS versions: 12 months of support
  • Regular versions: 3 months of support

Thank you for using nanobot! 🐈

Build docs developers (and LLMs) love