Metadata-Version: 2.4
Name: flowent
Version: 0.3.2
Summary: A workflow orchestration platform for multi-agent collaboration
Keywords: agent,agents,ai,ai-agents,assistant,automation,code-generation,llm,mcp,orchestration,sandbox,web-application,workflow
Author: ImFeH2
Author-email: ImFeH2 <i@feh2.im>
License-Expression: Apache-2.0
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
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
Requires-Dist: fastapi[standard]>=0.136.1
Requires-Dist: litellm>=1.84.0
Requires-Dist: mcp>=1.24.0
Requires-Dist: uvicorn>=0.46.0
Requires-Python: >=3.11
Project-URL: Homepage, https://github.com/ImFeH2/flowent
Project-URL: Issues, https://github.com/ImFeH2/flowent/issues
Project-URL: Repository, https://github.com/ImFeH2/flowent
Description-Content-Type: text/markdown

<p align="center">
  <img src="https://raw.githubusercontent.com/ImFeH2/flowent/main/assets/flowent-banner.png" alt="Flowent" width="100%" />
</p>

<p align="center">
  <a href="https://www.npmjs.com/package/flowent"><img src="https://img.shields.io/npm/v/flowent.svg?style=flat-square&label=npm" alt="npm version" /></a>
  <a href="https://pypi.org/project/flowent/"><img src="https://img.shields.io/pypi/v/flowent.svg?style=flat-square&label=PyPI" alt="PyPI version" /></a>
  <a href="https://github.com/ImFeH2/flowent/blob/main/LICENSE"><img src="https://img.shields.io/npm/l/flowent.svg?style=flat-square&label=License" alt="License" /></a>
  <a href="https://github.com/ImFeH2/flowent/actions/workflows/ci.yml"><img src="https://github.com/ImFeH2/flowent/workflows/CI/badge.svg" alt="CI" /></a>
  <a href="https://github.com/ImFeH2/flowent/actions/workflows/release.yml"><img src="https://github.com/ImFeH2/flowent/workflows/Release/badge.svg" alt="Release" /></a>
  <a href="https://github.com/ImFeH2/flowent/pkgs/container/flowent"><img src="https://github.com/ImFeH2/flowent/workflows/Docker/badge.svg" alt="Docker" /></a>
</p>

# Flowent

A workflow orchestration platform for multi-agent collaboration.

## Install

Flowent requires Bubblewrap for local tool isolation and ripgrep for file
search. Install the system packages first:

```bash
sudo apt-get install bubblewrap ripgrep
```

Install the CLI globally:

```bash
npm install -g flowent
```

Or install it with pip:

```bash
pip install flowent
```

Start the server:

```bash
flowent
```

Check system requirements:

```bash
flowent doctor
```

## Docker Compose

Run the server with Docker Compose:

```bash
docker compose up
```

## Tech Stack

- Vite: frontend development server and build tool.
- React: UI rendering model.
- FastAPI: local application server and settings API.
- uv: Python dependency and environment management.
- Tailwind CSS: utility-first styling.
- Shadcn UI: standard component patterns.
- Lucide Icons: shared icon set.
- Framer Motion: advanced interaction and transition animation.

## Development

Install dependencies and start the local development server:

```bash
sudo apt-get install bubblewrap ripgrep
pnpm install
uv sync --project backend
pnpm dev
```

You can also run the development container:

```bash
docker compose -f docker-compose.dev.yml up
```
