Metadata-Version: 2.4
Name: tuvl
Version: 0.0.1
Summary: Lightweight, AI-native orchestration
Author-email: Sooraj Rajagopalan <sooraj@tuvl.io>
License: MIT
Requires-Python: >=3.13
Requires-Dist: fastapi>=0.110.0
Requires-Dist: litellm>=1.35.0
Requires-Dist: neomodel>=5.3.0
Requires-Dist: pydantic>=2.7.0
Requires-Dist: pyyaml>=6.0.1
Requires-Dist: rich>=13.7.1
Requires-Dist: typer>=0.12.3
Requires-Dist: uvicorn>=0.30.0
Description-Content-Type: text/markdown

# 🪶 tuvl

> **Coming soon** — Lightweight, AI-native orchestration for building and deploying intelligent services.

`tuvl` lets you define, run, and manage multi-step AI agent workflows using plain YAML files. No boilerplate. No complex overhead. No lock-in.

---

## 🚦 Status

This package is currently a **name reservation**. The full AI-native engine and CLI are under active development.

* **Website:** [tuvl.io](https://tuvl.io)
* **GitHub:** [tuvl-io/public](https://github.com/tuvl-io/public)

---

## 📦 Components

The `tuvl` package provides a unified experience through three core functional areas:

| Component | Description |
| :--- | :--- |
| **`cli`** | **Command-Line Interface** — Create, validate, and manage workflows directly from your terminal. |
| **`core`** | **Engine Library** — The AI-native runtime for executing YAML-defined agentic workflows. |
| **`ui`** | **Admin UI** — A browser-based dashboard to visualize and explore your workflow states. |

---

## 🛠️ Usage (uv-first)

`tuvl` is designed to work seamlessly with [uv](https://github.com/astral-sh/uv).

### Installation

To install the `tuvl` CLI globally:
```bash
uv tool install tuvl