Metadata-Version: 2.4
Name: honcho-crewai
Version: 0.3.0
Summary: CrewAI integration with Honcho for persistent agent memory
Author-email: Plastic Labs <hello@plasticlabs.ai>
Maintainer-email: Plastic Labs <hello@plasticlabs.ai>
License: AGPL-3.0-or-later
Project-URL: Homepage, https://honcho.dev
Project-URL: Documentation, https://honcho.dev/docs/v3/integrations/crewai
Project-URL: Repository, https://github.com/plastic-labs/honcho
Project-URL: Bug Tracker, https://github.com/plastic-labs/honcho/issues
Project-URL: Changelog, https://github.com/plastic-labs/honcho/blob/main/CHANGELOG.md
Keywords: honcho,crewai,ai-agents,memory,agent-memory,persistent-memory
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Framework :: Pydantic
Requires-Python: <3.14,>=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: crewai<2.0.0,>=1.14.3
Requires-Dist: honcho-ai<3.0.0,>=2.1.1
Requires-Dist: openai>=1.0.0
Requires-Dist: python-dotenv>=1.0.0
Dynamic: license-file

# Honcho CrewAI Integration

Build CrewAI agents with persistent memory and reasoning capabilities powered by Honcho.

## Installation

```bash
uv add honcho-crewai crewai python-dotenv
```

CrewAI currently supports Python `>=3.10,<3.14`; this package follows the same range.

## Quick Start

```python
from crewai import Agent, Crew, Memory, Process, Task
from honcho import Honcho
from honcho_crewai import HonchoMemoryStorage

honcho = Honcho(workspace_id="crewai-demo")
storage = HonchoMemoryStorage(
    peer_id="user-123",
    session_id="session-123",
    honcho_client=honcho,
)
memory = Memory(storage=storage)

memory.remember(
    "The user is learning Python and wants to build web applications.",
    scope="/users/user-123",
    categories=["preferences"],
    metadata={"source": "onboarding"},
)

agent = Agent(
    role="Programming Mentor",
    goal="Help users learn programming by remembering their interests and progress",
    backstory="You are a patient programming mentor.",
)

task = Task(
    description="Suggest a Python web project that matches the user's interests.",
    expected_output="A specific project suggestion with a brief explanation",
    agent=agent,
)

crew = Crew(
    agents=[agent],
    tasks=[task],
    process=Process.sequential,
    memory=memory,
)

result = crew.kickoff()
print(result.raw)
```

## Features

- `HonchoMemoryStorage`: CrewAI unified `Memory` storage backend.
- `HonchoStorage`: compatibility adapter for older CrewAI `ExternalMemory` usage.
- `HonchoGetContextTool`, `HonchoDialecticTool`, and `HonchoSearchTool` for explicit Honcho memory retrieval.
- Lazy Honcho peer/session handles, matching the latest Honcho SDK get-or-create behavior.

## Documentation

For comprehensive guides, examples, and API reference, visit:
**[https://honcho.dev/docs/v3/integrations/crewai](https://honcho.dev/docs/v3/integrations/crewai)**

## Examples

Check out complete examples in the [GitHub repository](https://github.com/plastic-labs/honcho/tree/main/examples/crewai/python/examples).

## License

AGPL-3.0-or-later

## Support

- Report issues: [GitHub Issues](https://github.com/plastic-labs/honcho/issues)
- Documentation: [honcho.dev/docs](https://honcho.dev/docs)
- Website: [honcho.dev](https://honcho.dev)
