migrate-honcho

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

6.5k|796|Updated Sep 10, 2023
One-click install
npx skills add https://github.com/plastic-labs/honcho --skill migrate-honcho
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: migrate-honcho
Source: https://github.com/plastic-labs/honcho/tree/main/.claude/skills/migrate-honcho-py
Command: npx skills add https://github.com/plastic-labs/honcho --skill migrate-honcho

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps developers migrate the Honcho Python SDK from v1.6.0 to v2.0.0, addressing breaking changes and upgrade pitfalls.

Core Features & Use Cases

  • Async architecture updates: switch to Honcho with .aio accessor; adapt to the new terminology (Conclusion, ConclusionScope, ConclusionScopeAio) and API type shifts.
  • API and configuration migration: rename get_config to get_configuration and related methods; migrate to honcho.api_types for typed configuration objects; adjust streaming usage with chat_stream().
  • Migration guidance: step-by-step guidance for updating imports, method names, and removing deprecated features like core property and poll_deriver_status.

Quick Start

  1. Upgrade the honcho package to v2.0.0 and switch code to Honcho and the .aio accessor for async calls.
  2. Replace Observation-related imports with Conclusion equivalents and switch representation handling to strings via peer.representation().
  3. Update configuration calls to get_configuration/set_configuration and adjust APIs accordingly.

Frequently Asked Questions about migrate-honcho

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

FAQPage Schema
How do I migrate the Honcho Python SDK to v2.0.0?

To migrate the Honcho Python SDK to v2.0.0, upgrade the package, switch code to the Honcho .aio accessor for async calls, and replace deprecated methods and types with honcho.api_types equivalents.

What breaking changes are in the Honcho v2.0.0 update?

Breaking changes in the Honcho v2.0.0 update include renaming get_config to get_configuration, replacing Observation with Conclusion types, and removing deprecated features like the core property and poll_deriver_status.

How do I handle async architecture updates for Honcho v2.0.0?

Handle async architecture updates for Honcho v2.0.0 by leveraging the Honcho .aio accessor for asynchronous calls and updating imports to align with the new Conclusion and ConclusionScopeAio types.

Can I still use Observation imports with Honcho v2.0.0?

No, you cannot use Observation imports with Honcho v2.0.0. You must replace them with Conclusion equivalents and switch representation handling to strings via peer.representation().

How do I adjust streaming usage in the Honcho v2.0.0 API?

Adjust streaming usage in the Honcho v2.0.0 API by updating your code to use the chat_stream() method and migrating configuration objects to the honcho.api_types module for typed configurations.

Why does my Honcho migration fail after upgrading to v2.0.0?

Your Honcho migration fails after upgrading to v2.0.0 if you have not updated method names like get_configuration, removed deprecated properties like poll_deriver_status, or aligned types to honcho.api_types.