Metadata-Version: 2.4
Name: charmos
Version: 0.4.12
Summary: The Unified System Layer for Agentic Intelligence
Author-email: ucmind <team@charmos.io>
Project-URL: Homepage, https://charmos.io
Project-URL: Repository, https://github.com/CharmAIOS/Charm
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: typer>=0.9.0
Requires-Dist: rich>=13.0.0
Requires-Dist: httpx>=0.25.0
Requires-Dist: tomlkit>=0.12.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: pyyaml>=6.0
Requires-Dist: supabase>=2.0.0
Requires-Dist: gitpython>=3.1.0
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: langchain>=0.1.0
Requires-Dist: langchain-core
Requires-Dist: langgraph
Requires-Dist: crewai
Provides-Extra: runner
Requires-Dist: docker>=7.0.0; extra == "runner"
Provides-Extra: dev
Requires-Dist: ruff; extra == "dev"
Requires-Dist: pytest; extra == "dev"
Requires-Dist: mypy; extra == "dev"
Requires-Dist: pre-commit; extra == "dev"
Dynamic: license-file

<p align="center">
  <img src="assets/banner.png" alt="Charm Banner" width="100%" />
</p>

<p align="center">
  <a href="https://charmos.io/">Homepage</a> ·
  <a href="https://github.com/CharmAIOS/Charm/tree/main/docs">Documentation</a> ·
  <a href="https://github.com/CharmAIOS/Charm/blob/main/CONTRIBUTING.md">Contributing</a> ·
  <a href="https://discord.gg/gdakynHUEb">Discord</a>
</p>

# Charm: The Unified Platform for Agentic Intelligence

> **Current Status: v0.4.10 (Developer Preview)**

**Charm** is a **Unified System Layer** that governs the development, execution, and distribution of AI agents.

It provides a standardized architecture that enables agents to assemble, interoperate, and scale across heterogeneous ecosystems, turning them into real, commercial-ready applications.

---

## Why Charm?

Before you dive deeper, we’d like you to take a moment to read this [blog post](https://charmos.io/blog/1) to understand our insights and perspective.

## Getting started

To explore Charm’s core concepts and code in more detail, check out our [documentation](https://github.com/CharmAIOS/Charm/tree/main/docs).

### Installation

Charm is available on PyPI. We recommend using [uv](https://github.com/astral-sh/uv) for the best experience.

#### Standard Setup (For Agent Development)

If you only want to build and define agents

```bash
uv add charmos
# or
pip install charmos
```

#### Advanced Setup (For Local Cloud Runner)

If you want to simulate the isolated cloud environment locally (requires Docker)

```bash
uv add charmos[runner]
# or
pip install charmos[runner]
```

> **Note:** To use the docker simulation mode, you must have Docker Desktop or Docker Engine running on your machine.
>
## Contributing

To learn how to contribute to Charm, please read the contribution guide [here](https://github.com/CharmAIOS/Charm/blob/main/CONTRIBUTING.md).

## Contact

- Support and Questions: [Community](https://discord.gg/gdakynHUEb) / [Email](mailto:team@charmos.io)
- Join us: [Chat with founder](mailto:uc@charmos.io)

## Changelog

Check our [updates](https://charmos.io/changelog)

## License

Charm is licensed under the [GNU Affero General Public License v3.0](https://github.com/CharmAIOS/CharmOS/blob/main/LICENSE)
