Open-source AI agent that runs on your machine — one memory, every channel, your own LLM keys
Project description
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.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file flowly_ai-3.0.1.tar.gz.
File metadata
- Download URL: flowly_ai-3.0.1.tar.gz
- Upload date:
- Size: 2.0 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
2a0b5a94b849cda04c7ff8d68bfa26081dae481fb0e2a4898dceebff199c5eaa
|
|
| MD5 |
a5322245a73f4b3b9d1f9022019c343d
|
|
| BLAKE2b-256 |
fce4a0647aad9acfbbd45c33915f8cafe5caff58ea1474bab6f5f48509a4a741
|
File details
Details for the file flowly_ai-3.0.1-py3-none-any.whl.
File metadata
- Download URL: flowly_ai-3.0.1-py3-none-any.whl
- Upload date:
- Size: 2.4 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
2ce1c781fdb2d1fa35e58e96d273f593d24ffe364af7f12e5d69d6aff66e368c
|
|
| MD5 |
1ddff148aac72270583c28ecbea5f143
|
|
| BLAKE2b-256 |
50295ad3a1b25506c83c7130e40c605117773a22519fab95122810cf64374854
|