Skip to main content

Open-source AI agent that runs on your machine — one memory, every channel, your own LLM keys

Project description

Flowly — one brain, everywhere you work

PyPI Python Platform License

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 /provider and /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-exec on macOS, bubblewrap on 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


Apache 2.0. Fork it, ship it, embed it. Self-hosted use with your own LLM keys is unrestricted.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

flowly_ai-3.0.1.tar.gz (2.0 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

flowly_ai-3.0.1-py3-none-any.whl (2.4 MB view details)

Uploaded Python 3

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

Hashes for flowly_ai-3.0.1.tar.gz
Algorithm Hash digest
SHA256 2a0b5a94b849cda04c7ff8d68bfa26081dae481fb0e2a4898dceebff199c5eaa
MD5 a5322245a73f4b3b9d1f9022019c343d
BLAKE2b-256 fce4a0647aad9acfbbd45c33915f8cafe5caff58ea1474bab6f5f48509a4a741

See more details on using hashes here.

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

Hashes for flowly_ai-3.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 2ce1c781fdb2d1fa35e58e96d273f593d24ffe364af7f12e5d69d6aff66e368c
MD5 1ddff148aac72270583c28ecbea5f143
BLAKE2b-256 50295ad3a1b25506c83c7130e40c605117773a22519fab95122810cf64374854

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page