Metadata-Version: 2.4
Name: zil-ai
Version: 0.1.14
Summary: A framework for production AI agents
Project-URL: Homepage, https://getzil.dev
Project-URL: Repository, https://github.com/fluentdata-co/zil
Project-URL: Documentation, https://getzil.dev/docs
Author-email: FluentData <hello@fluentdata.co>
License-Expression: Apache-2.0
License-File: LICENSE
Keywords: a2a,adk,agents,ai,mcp,observability
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Requires-Python: >=3.11
Requires-Dist: click<9,>=8.1
Requires-Dist: jinja2<4,>=3.1
Requires-Dist: jsonschema<5,>=4.20
Requires-Dist: oras<1,>=0.2
Requires-Dist: pydantic<3,>=2.0
Requires-Dist: pyyaml<7,>=6.0
Requires-Dist: rich<14,>=13.0
Provides-Extra: adk
Requires-Dist: google-adk<2,>=1.0.0; extra == 'adk'
Requires-Dist: mcp<2,>=1.0.0; extra == 'adk'
Requires-Dist: opentelemetry-exporter-otlp-proto-http>=1.20.0; extra == 'adk'
Provides-Extra: dev
Requires-Dist: mypy<2,>=1.10; extra == 'dev'
Requires-Dist: pytest-cov<6,>=5.0; extra == 'dev'
Requires-Dist: pytest<9,>=8.0; extra == 'dev'
Requires-Dist: ruff<1,>=0.4; extra == 'dev'
Provides-Extra: eval
Requires-Dist: deepeval<3,>=2.0; extra == 'eval'
Description-Content-Type: text/markdown

<div align="center">

# Zil

**A framework for production AI agents.**

[![PyPI](https://img.shields.io/pypi/v/zil-ai?color=e8c87a&style=flat-square)](https://pypi.org/project/zil-ai/)
[![Python](https://img.shields.io/pypi/pyversions/zil-ai?style=flat-square)](https://pypi.org/project/zil-ai/)
[![License](https://img.shields.io/badge/license-Apache--2.0-blue?style=flat-square)](LICENSE)
[![Slack](https://img.shields.io/badge/Slack-Join%20Community-4A154B?style=flat-square&logo=slack)](https://join.slack.com/t/zilorg/shared_invite/zt-3xye83sw1-cU3H1Hb_yFbmyBBgbt5VGQ)

[Documentation](https://getzil.dev/docs) · [Getting Started](https://getzil.dev/docs/getting-started) · [CLI Reference](https://getzil.dev/docs/cli) · [Community Slack](https://join.slack.com/t/zilorg/shared_invite/zt-3xye83sw1-cU3H1Hb_yFbmyBBgbt5VGQ)

</div>

---

Zil composes with [ADK](https://google.github.io/adk-docs/), [A2A](https://google.github.io/A2A/), [MCP](https://modelcontextprotocol.io/), [DeepEval](https://github.com/confident-ai/deepeval), and [OpenTelemetry](https://opentelemetry.io/) to provide a declarative manifest format and CLI for building, validating, auditing, packaging, and deploying AI agents.

## Install

```bash
pip install zil-ai
```

For agent creation with ADK:

```bash
pip install 'zil-ai[adk]'
```

## Quick start

```bash
# Scaffold a new agent project
zil init my-agent
cd my-agent && source .venv/bin/activate

# Validate the project
zil validate

# Security audit
zil audit --fix

# Run the agent interactively
zil run

# Or start the ADK web UI
zil web
```

## Commands

| Command | Description |
|---------|-------------|
| `zil init` | Scaffold a new agent project |
| `zil validate` | Validate project against the manifest schema |
| `zil audit` | Agent-native security audit (injection, leakage, identity hardening) |
| `zil eval run` | Run evaluation suites |
| `zil eval generate` | LLM-powered eval case synthesis |
| `zil run` | Run the agent interactively |
| `zil web` | Start the ADK web UI for testing |
| `zil pack` | Build a versioned `.zil` archive |
| `zil push` | Push archives to an OCI-compatible registry |
| `zil deploy` | Deploy to Google Cloud Run with eval gating |

## SDK

```python
import zil

root_agent = zil.create_agent(
    tools=[],              # your tool functions
    enable_guardrails=True, # runtime guardrail engine
    enable_telemetry=True,  # OpenTelemetry tracing
)
```

See the [SDK Reference](https://getzil.dev/docs/sdk) for the full API.

## Example

The [`examples/hello-agent`](examples/hello-agent) directory contains a minimal reference agent you can run immediately:

```bash
cd examples/hello-agent
pip install -r requirements.txt
zil validate && zil audit && zil run
```

## Community

- **Slack** — [Join the Zil community](https://join.slack.com/t/zilorg/shared_invite/zt-3xye83sw1-cU3H1Hb_yFbmyBBgbt5VGQ) for questions, feedback, and discussion
- **GitHub Discussions** — [Ask questions and share ideas](https://github.com/fluentdata-co/zil/discussions)
- **Issues** — [Report bugs or request features](https://github.com/fluentdata-co/zil/issues)

## Contributing

We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup, testing, and PR guidelines.

## License

[Apache-2.0](LICENSE)

---

<sub>Built by <a href="https://fluentdata.ai">FluentData</a></sub>
