Metadata-Version: 2.4
Name: charmos
Version: 0.4.16
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/charm-banner.png" alt="Charm Banner" width="100%" />
</p>

<p align="center">
  <a href="https://charmos.io/">Homepage</a> .
  <a href="https://store.charmos.io/">Store</a> .
  <a href="https://discord.gg/gdakynHUEb">Discord</a>
</p>

# Charm: The Unified Platform for Agentic Intelligence

> **Charm Store** is now live. Register your agent and explore what the community has built!

**Charm** is a **Unified System Layer** designed to provide a unified environment for capability integration and application distribution for agentic intelligence.

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, I’d like you to take a moment to read the [blog post](https://charmos.io/blog) to understand our insights and perspective.

## Getting started

### 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

```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.
>
### Register your agent

Read our simple [tutorial](https://github.com/CharmAIOS/Charm/blob/main/docs/concepts/charm-store.md) to learn how to register your agent on the Charm Store.

## Contributing

To know how to contribute to Charm, please read our [contribution guide](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 us](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)
