# Flowllm

> FlowLLM: Build LLM applications with ease.

- **Type:** MCP server
- **Install:** `agentstack add mcp-flowllm-ai-flowllm`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [FlowLLM-AI](https://agentstack.voostack.com/s/flowllm-ai)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [FlowLLM-AI](https://github.com/FlowLLM-AI)
- **Source:** https://github.com/FlowLLM-AI/flowllm

## Install

```sh
agentstack add mcp-flowllm-ai-flowllm
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

FlowLLM: Build LLM applications with ease.

FlowLLM is a configuration-driven LLM application framework that organizes workflows, service entrypoints, and
long-lived components with **Service, Job, Step, and Component**.

## ✨ Core Features

- **Configuration-driven**: Starts from `flowllm/config/default.yaml`, with config files and dot-notation overrides.
- **Unified path**: `CLI / Client -> Service -> Application -> Job -> Step -> Component`.
- **Flexible Jobs**: Supports sync, streaming, background, and scheduled tasks exposed through HTTP or MCP.
- **Pluggable components**: Extend Steps, Services, Clients, LLMs, Embeddings, Embedding Stores, and Agent Wrappers
  through registry `R`.

  

## 🧠 FlowLLM Development Skill

FlowLLM ships with a development Skill for coding agents. It explains the framework conventions, repository map,
extension points, testing workflow, and review checklist for building or extending FlowLLM applications.

Start here when changing the codebase: [FlowLLM Development Skill](skills/flowllm_dev/SKILL.md).

## 📝 Technical Notes

| Note                                                                      | Description                                                                                           |
|---------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------|
| [Context Management Design](note/context_management_design.md)            | Short-term agent context management design, including history compaction and tool-result truncation.  |
| [SELFCOMPACT and AgentScope PR #1938](note/self_compact_agentscope_pr.md) | Technical reading notes for the SELFCOMPACT paper, experiments, and the AgentScope implementation PR. |

## 🚀 Quick Start

### Installation

FlowLLM requires Python 3.11+.

Install from pip:

```bash
pip install flowllm
```

Install from source:

```bash
git clone https://github.com/flowllm-ai/flowllm.git
cd flowllm
pip install -e .
```

### Start the Service

```bash
flowllm start
```

The default service address is `127.0.0.1:2333`, and the default workspace is `.flowllm/`.
Override configuration with dot notation:

```bash
flowllm start service.port=8181 enable_logo=false
flowllm start workspace_dir=/tmp/flowllm-demo service.host=127.0.0.1 service.port=8181
```

See the [Quick Start](docs/en/quick_start.md) for more startup and invocation examples.

## 🧩 Use FlowLLM

```bash
flowllm version
flowllm health_check
flowllm help
flowllm demo query="Hello FlowLLM" min_score=0.8
flowllm add a=1 b=2
```

CLI commands other than `start` call server-side Jobs with the same name. HTTP uses `POST /`:

```bash
curl -s http://127.0.0.1:2333/add \
  -H 'Content-Type: application/json' \
  -d '{"a":1,"b":2}'
```

See [Quick Start](docs/en/quick_start.md) for service, CLI, HTTP, and streaming examples.

## ⚙️ Build Applications

FlowLLM applications are configured from `flowllm/config/default.yaml` or your own YAML/JSON config. Add a capability by
registering a Step or Component, then exposing it as a Job:

```yaml
jobs:
  reverse:
    backend: base
    description: "reverse text"
    steps:
      - backend: reverse_step
```

Configuration supports `.env`, `${VAR}`, `${VAR:-default}`, dot-notation overrides, and direct config files:

```bash
flowllm start config=/path/to/app.yaml
```

For implementation rules and examples, use the [FlowLLM Development Skill](skills/flowllm_dev/SKILL.md). For the compact
architecture reference, see [Code Framework](docs/en/framework.md).

## 🆕 Minimal CLI Flow

For scripts that do not need the full service framework, `flowllm.lite` maps `fl --action --field value` to a Pydantic
config and a small ordered `BaseFlow`. See [FlowLLM Lite](flowllm/lite/README.md).

## 🗺️ Roadmap

| Item                      | Description                                                                                         |
|---------------------------|-----------------------------------------------------------------------------------------------------|
| Agent wrapper integration | Integrate FlowLLM into Agent wrappers so agents can develop FlowLLM Steps and Jobs from your ideas. |
| TypeScript frontend       | Add a TypeScript frontend for building and developing FlowLLM applications through the UI.          |

## 📚 Documentation

- [Quick Start](docs/en/quick_start.md)
- [Code Framework](docs/en/framework.md)
- [Contributing](docs/en/contributing.md)
- [FlowLLM Development Skill](skills/flowllm_dev/SKILL.md)

## 🤝 Open Source and Contributing

FlowLLM is licensed under Apache 2.0. Before contributing, read the [contribution guide](docs/en/contributing.md)
and [development skill](skills/flowllm_dev/SKILL.md).

Install development dependencies from source:

```bash
pip install -e ".[dev]"
```

Before submitting changes, run:

```bash
pre-commit run --all-files
pytest
```

## 📄 License

This project is open source under the Apache License 2.0. See [LICENSE](./LICENSE) for details.

## ⭐ Star History

[](https://www.star-history.com/#flowllm-ai/flowllm&Date)

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [FlowLLM-AI](https://github.com/FlowLLM-AI)
- **Source:** [FlowLLM-AI/flowllm](https://github.com/FlowLLM-AI/flowllm)
- **License:** Apache-2.0

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** yes
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-flowllm-ai-flowllm
- Seller: https://agentstack.voostack.com/s/flowllm-ai
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.