migrate-py

Migrate Honcho Python SDK code from v1.6.0 to v2.0.0.

6|1|Updated Feb 18, 2026
One-click install
npx skills add https://github.com/plastic-labs/cursor-honcho --skill migrate-py
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: migrate-py
Source: https://github.com/plastic-labs/cursor-honcho/tree/main/plugins/honcho-dev/skills/migrate-py
Command: npx skills add https://github.com/plastic-labs/cursor-honcho --skill migrate-py

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates and documents the migration of Python code that depends on the Honcho SDK from v1.6.0 to v2.0.0, preventing runtime errors and broken imports caused by removed classes, renamed APIs, and changed return types.

Core Features & Use Cases

  • Import and async architecture updates: guidance to replace AsyncHoncho/AsyncPeer/AsyncSession with Honcho and the .aio accessor and update async type hints.
  • API and type migrations: instructions for renaming Observation→Conclusion, handling Representation → str changes, updating configuration method names, and switching to chat_stream and queue_status patterns.
  • Use Case: apply the checklist and examples to a Python project or CI pipeline that broke after upgrading honcho to v2.0.0 to restore compatibility and correct typing.

Quick Start

Use the migrate-py skill to update a repository that imports AsyncHoncho and Observation so it uses Honcho with .aio and the v2.0.0 API names.

Frequently Asked Questions about migrate-py

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I migrate Honcho Python SDK from v1.6.0 to v2.0.0?

To migrate Honcho Python SDK to v2.0.0, replace AsyncHoncho/AsyncPeer/AsyncSession imports with Honcho and the .aio accessor, and update async type hints to restore compatibility.

Why does my Honcho code break after upgrading to v2.0.0?

Your Honcho code breaks after upgrading to v2.0.0 due to removed classes like Observation and renamed APIs. You must rename Observation to Conclusion and update configuration methods to resolve runtime errors.

What is the best way to handle Representation changes in the Honcho v2.0.0 update?

Handling Representation changes in the Honcho v2.0.0 update requires converting Representation objects to standard Python strings and switching to chat_stream and queue_status patterns.

Do I need to update async type hints when refactoring Honcho SDK to v2.0.0?

Yes, you need to update async type hints when refactoring Honcho SDK to v2.0.0 by adopting the .aio accessor conversions replacing the previous AsyncPeer and AsyncSession architecture.

Can I use this migration checklist in a CI pipeline for Python projects?

You can apply this migration checklist to a Python project or CI pipeline that broke after upgrading honcho to v2.0.0 to automatically restore compatibility and correct typing.

How do I update get_config and streaming flags for Honcho v2.0.0 compatibility?

Updating get_config and streaming flags for Honcho v2.0.0 compatibility involves adjusting configuration method names and applying the required streaming behavior changes during the refactor.