Flowly is an open-source AI agent that runs on your machine, meets you on every channel you already use, and gets better the longer you use it. One shared memory, one library of skills, your own LLM keys. It remembers across conversations, maintains and improves itself over time, schedules its own work, and connects to anything that speaks MCP — from a $5 VPS, a Mac mini, or the laptop in front of you.
Install
# One command sets up uv, Python, and Flowly
curl -fsSL https://useflowlyapp.com/install.sh | bash
# Already manage tools with uv?
uv tool install flowly-ai
flowly setup # pick an LLM provider, add any channels
flowly # open the terminal UI
What's inside
- One agent, every channel — Terminal TUI · Telegram · Discord · Slack · Microsoft Teams · WhatsApp · iMessage · Email · voice. A single gateway process speaks to all of them, with one conversation memory shared across every surface.
- Bring your own key — OpenRouter, Anthropic, OpenAI, Google Gemini, Groq, xAI/Grok, Zhipu/GLM, and any OpenAI-compatible local model (Ollama, LM Studio, vLLM). When nothing is pinned, Flowly cascades through whatever you've configured so it always has a working model. Switch live with
/providerand/model. Sign in to xAI with your SuperGrok / X Premium+ subscription instead of an API key. - A closed learning loop — every fact becomes a governed memory with a calibrated trust score; a background pass merges duplicates and retires stale notes; structured facts land in a knowledge graph. Opt in and Flowly writes and refines its own skills — every change snapshotted and reversible.
- 135 built-in skills plus skill bundles and drop-in Markdown skills, compatible with the open agentskills.io standard.
- MCP, both directions — connect any MCP server (
flowly mcp install …) and run Flowly itself as an MCP server (flowly mcp serve) for Claude Desktop, Cursor, or Claude Code. - Delegates and parallelizes — spawn isolated sub-agents, run a cross-channel task board sequentially or in parallel, and hand heavy coding off to a local Codex session (opt-in).
- Scheduled & unattended — built-in cron schedules any natural-language prompt to any channel, and the gateway runs as a background service that survives reboots.
- Yours to extend & contain — full Python plugins (tools, slash commands, channels, lifecycle hooks), switchable personas, and an OS sandbox (
sandbox-execon macOS,bubblewrapon Linux).
Self-host or cloud
Flowly's agent core is Apache 2.0 — self-host on your laptop, a VPS, or a Mac mini with your own LLM keys, no account required. Optional Flowly Cloud adds native Mac/iOS/Android apps, cross-device sync, hosted LLM access, and a managed relay that keeps your bot reachable when your laptop sleeps.
Links
- Documentation — https://useflowlyapp.com/docs
- Source & issues — https://github.com/Nocetic/flowly
- Website & apps — https://useflowlyapp.com
Apache 2.0. Fork it, ship it, embed it. Self-hosted use with your own LLM keys is unrestricted.
Metadata
Release files for flowly-ai 3.0.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| flowly_ai-3.0.1.tar.gz | 2.0 MB | Without provenance | Details for flowly_ai-3.0.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| flowly_ai-3.0.1-py3-none-any.whl | Python 3 | none | any | Details for flowly_ai-3.0.1-py3-none-any.whl |
Total release size: 4.3 MB
Release files / flowly_ai-3.0.1.tar.gz
| Download URL | flowly_ai-3.0.1.tar.gz |
|---|---|
| Size | 2.0 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
2a0b5a94b849cda04c7ff8d68bfa26081dae481fb0e2a4898dceebff199c5eaa
|
|
BLAKE2b-256 checksum How to use checksums |
fce4a0647aad9acfbbd45c33915f8cafe5caff58ea1474bab6f5f48509a4a741
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.5
|
Release files / flowly_ai-3.0.1-py3-none-any.whl
| Download URL | flowly_ai-3.0.1-py3-none-any.whl |
|---|---|
| Size | 2.4 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
2ce1c781fdb2d1fa35e58e96d273f593d24ffe364af7f12e5d69d6aff66e368c
|
|
BLAKE2b-256 checksum How to use checksums |
50295ad3a1b25506c83c7130e40c605117773a22519fab95122810cf64374854
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.5
|
Security for flowly-ai 3.0.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.