Skip to content
Back to search

1flowbase

Build for agents — from the AI Gateway to the entire application stack.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/taichuy/1flowbase with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/taichuy/1flowbase'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/taichuy--1flowbase/badge.svg)](/listings/taichuy--1flowbase)

HTML

<a href="/listings/taichuy--1flowbase"><img src="/api/listings/taichuy--1flowbase/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

These steps run a script from the network that findsafeskills does not scan.

Docker

Deployed with Docker — no manual environment setup required.

**Linux / macOS**

curl -fsSL https://raw.githubusercontent.com/taichuy/1flowbase/main/scripts/shell/docker-deploy.sh | sh

**Windows PowerShell**

irm https://raw.githubusercontent.com/taichuy/1flowbase/main/scripts/powershell/docker-deploy.ps1 | iex

**Windows CMD**

powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://raw.githubusercontent.com/taichuy/1flowbase/main/scripts/powershell/docker-deploy.ps1 | iex"

Follow the prompts to finish configuration and start 1flowbase. Storing full conversations can generate large data volumes; for high-traffic production, plan storage capacity, retention, backup, and compliance in advance.

Git

**Requirements**

- Node.js `>=24.0.0` - pnpm `11.x` (enable via `corepack enable`) - Rust stable toolchain (Cargo) - Docker with Docker Compose (for middleware such as PostgreSQL)

**Start**

Run from the repository root:

git clone https://github.com/taichuy/1flowbase.git
cd 1flowbase
node scripts/node/dev-up.js

`dev-up` starts the Docker middleware, installs frontend dependencies, builds and runs the backend, and starts the frontend. Other common commands:

node scripts/node/dev-up.js status
node scripts/node/dev-up.js stop
node scripts/node/dev-up.js restart --frontend-only
node scripts/node/dev-up.js restart --backend-only

Logs are written to `tmp/logs/`. For more scripts, see [scripts/README.md](scripts/README.md).

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 264 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # 1flowbase
  2. <p align="center">
  3. <img src="web/app/public/icon.svg" alt="1flowbase Logo" width="120" height="120">
  4. </p>
  5. <p align="center">
  6. <b>English</b> | <a href="docs/READEME-i18n/README_CN.md">简体中文</a>
  7. </p>
  8. <p align="center">
  9. <a href="https://github.com/taichuy/1flowbase/stargazers"><img src="https://img.shields.io/github/stars/taichuy/1flowbase?style=social" alt="GitHub stars"></a>
  10. <a href="LICENSE"><img src="https://img.shields.io/github/license/taichuy/1flowbase" alt="License"></a>
  11. <img src="https://img.shields.io/badge/OpenAI-compatible-111827" alt="OpenAI compatible">
  12. <img src="https://img.shields.io/badge/Claude-compatible-111827" alt="Claude compatible">
  13. <img src="https://img.shields.io/badge/MCP-gateway-7c3aed" alt="MCP gateway">
  14. <img src="https://img.shields.io/badge/Application_Backend-CRUD-0f766e" alt="Application Backend with CRUD APIs">
  15. <img src="https://img.shields.io/badge/Native_React-blocks-149eca" alt="Native React blocks">
  16. <img src="https://img.shields.io/badge/self--hosted-1flowbase-2563eb" alt="Self-hosted">
  17. </p>
  18. <p align="center">
  19. <strong>Community:</strong>
  20. <a href="docs/assets/community/wechat.jpg" target="_blank">WeChat</a> |
  21. <a href="docs/assets/community/taichuy_doc_wechat_office.png" target="_blank">WeChat Official Account</a> |
  22. <a href="https://x.com/Tacihu2021" target="_blank">Twitter</a>
  23. </p>
  24. > ## From AI Gateway to a Complete Application System.
  25. 1flowbase is a low-code native backend foundation built on an AI gateway. Beyond core AI gateway features, it lets you build your own application system on top of the AI chat data stored in the gateway.
  26. <p align="center">
  27. <img src="docs/assets/why-1flowbase_en.png" alt="Why 1flowbase">
  28. </p>
  29. ## An Application Foundation Designed for Agents
  30. 1flowbase is API-first by design. If a traditional GUI can take over the entire system through APIs, then turning those APIs into MCP lets an Agent take over everything as well.
  31. <p align="center">
  32. <img src="docs/assets/architecture_yewu_en.png" alt="1flowbase Business Architecture">
  33. </p>
  34. ## Technical Architecture
  35. <p align="center">
  36. <img src="docs/assets/architecture_jishu_en.png" alt="1flowbase Technical Architecture">
  37. </p>
  38. **1flowbase is a self-hosted AI Gateway and AI application runtime.**
  39. Start by unifying model access, retain conversation data in the same runtime, and keep building **Workflows, APIs, business data, and React applications** on top of it. Every capability is API-based and can be exposed to Agents through MCP to understand, build, and manage.
  40. **Dispatch intelligence, retain data, build applications.**
  41. ---
  42. ## Philosophy
  43. - **The gateway is not the end**: Full AI conversations passing through the gateway are stored in PostgreSQL, becoming a reusable data asset for cost analysis, model quality evaluation, prompt / routing optimization, and business system development.
  44. - **A "model" can be a Workflow**: High-capability models plan, judge, and audit; low-cost models execute. The combination is published as a single virtual model, and a model can itself be used as a Tool by another model.
  45. - **Three protocols, one entry point**: Conversion between Anthropic Messages, OpenAI Chat Completions, and OpenAI Responses, so your application layer doesn't change when providers do.
  46. - **Designed for Agents**: Every runtime operation available in the GUI is built on APIs, which are exposed to Agents via MCP. The MCP Gateway uses progressive `list / get / call` tool discovery instead of stuffing every Tool into the context at once.
  47. - **Low-code efficiency + native React freedom**: Business tables can be created dynamically; UIs are written as React code blocks with access to the entire React ecosystem, not a closed drag-and-drop editor.
  48. ```text
  49. Human → GUI ─┐
  50. ├→ API → AI Gateway / Workflow / Data / React UI → AI Application
  51. Agent → MCP ─┘
  52. ```
  53. ---
  54. ## Quick Start
  55. ### Docker
  56. Deployed with Docker — no manual environment setup required.
  57. **Linux / macOS**
  58. ```bash
  59. curl -fsSL https://raw.githubusercontent.com/taichuy/1flowbase/main/scripts/shell/docker-deploy.sh | sh
  60. ```
  61. **Windows PowerShell**
  62. ```powershell
  63. irm https://raw.githubusercontent.com/taichuy/1flowbase/main/scripts/powershell/docker-deploy.ps1 | iex
  64. ```
  65. **Windows CMD**
  66. ```cmd
  67. powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://raw.githubusercontent.com/taichuy/1flowbase/main/scripts/powershell/docker-deploy.ps1 | iex"
  68. ```
  69. Follow the prompts to finish configuration and start 1flowbase. Storing full conversations can generate large data volumes; for high-traffic production, plan storage capacity, retention, backup, and compliance in advance.
  70. ### Git
  71. **Requirements**
  72. - Node.js `>=24.22.1`
  73. - pnpm `12.11.2` (run `corepack enable` and `corepack install --global pnpm@12.11.2`)
  74. - Rust stable toolchain (Cargo), version `1.99` or newer
  75. - Docker with Docker Compose (for middleware such as PostgreSQL)
  76. **Start**
  77. Run from the repository root:
  78. ```bash
  79. git clone https://github.com/taichuy/1flowbase.git
  80. cd 1flowbase
  81. ```
  82. Before the first source build on Linux with a user systemd manager, apply the
  83. development resource profile and put its user-level wrappers on PATH:
  84. ```bash
  85. bash scripts/shell/apply-resource-limits.sh
  86. export PATH="$HOME/.local/bin:$PATH"
  87. ```
  88. Rust normally uses half the available CPU and memory, targeting at least 2 logical
  89. CPUs and 8 GiB when capacity permits. Smaller machines may exceed the half-machine
  90. share; memory still leaves OS/service headroom. These are build budget targets,
  91. not verified minimum hardware requirements. Explicit local settings remain supported.
  92. Windows/macOS use the same CPU policy; Linux systemd memory limits do not apply there.
  93. See [resource configuration](scripts/README.md#dev-runtime) for limits and overrides.
  94. For first-time development, precompile the Rust test targets, then start the services:
  95. ```bash
  96. node scripts/node/reset-rust-cache/cli.js --warmup-only
  97. node scripts/node/dev-up.js
  98. ```
  99. `--warmup-only` fetches locked dependencies and compiles build/test targets in sequence
  100. without deleting existing caches or stopping services; it does not execute tests.
  101. For subsequent daily starts, run `dev-up` directly to reuse the caches.
  102. `dev-up` starts the Docker middleware, installs frontend dependencies, builds and runs the backend, and starts the frontend. Other common commands:
  103. ```bash
  104. node scripts/node/dev-up.js status
  105. node scripts/node/dev-up.js stop
  106. node scripts/node/dev-up.js restart --frontend-only
  107. node scripts/node/dev-up.js restart --backend-only
  108. ```
  109. Logs are written to `tmp/logs/`. For more scripts, see [scripts/README.md](scripts/README.md).
  110. ---
  111. ## Comparison
  112. | Project | AI Gateway | Composite Models / Workflow | Full Conversation Data | Dynamic Business Data | MCP | React Apps |
  113. | ---------- | ---------- | --------------------------- | ---------------------- | --------------------- | ------------ | ---------------- |
  114. | 1flowbase | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
  115. | LiteLLM | ✅ | — | Partial | — | — | — |
  116. | OpenRouter | ✅ | — | Platform-hosted | — | — | — |
  117. | Dify | Partial | ✅ | ✅ | — | ✅ | Fixed app types |
  118. | Supabase | — | — | — | ✅ | Ecosystem | Build your own |
  119. | n8n | — | ✅ | — | — | Ecosystem | — |
  120. ---
  121. ## Roadmap
  122. - Out-of-the-box application templates (AI Gateway, multi-model router, enterprise AI Gateway, AI education platform, Agent application backend)
  123. - Better official MCP Tool descriptions so Coding Agents like Codex can build applications without reading the source code
  124. - Lifecycle management for AI conversation data
  125. ---
  126. ## Tutorials
  127. - [Make GLM-5.2 See Images in Claude Code with 1flowbase](https://github.com/taichuy/1flowbase/wiki/Make-GLM-5.2-See-Images-in-Claude-Code-with-1flowbase-CN)
  128. - [Fusion-Style Workflow: Publish a Multi-Model Review Panel as an Observable Virtual Model](https://github.com/taichuy/1flowbase/wiki/Fusion-Style-Workflow-CN)
  129. - [1flowbase Wiki](https://github.com/taichuy/1flowbase/wiki)
  130. ---
  131. ## Repository Layout
  132. ```text
  133. web/ Frontend root, powered by pnpm + Turbo
  134. api/ Rust backend workspace
  135. api/apps/ Backend service entry points
  136. api/crates/ Shared backend crates
  137. api/plugins/ Plugin source workspace, HostExtension manifests and templates
  138. docker/ Local middleware orchestration and self-hosted service stack
  139. scripts/ Repository-level development, testing, verification, and debugging scripts
  140. ```
  141. ---
  142. ## Contributing
  143. Community contributions are very welcome. Before submitting a Pull Request, please run the following verification script:
  144. ```bash
  145. node scripts/node/verify.js repo
  146. ```
  147. Development guidelines:
  148. - [AGENTS.md](../../AGENTS.md)
  149. - [web/AGENTS.md](../../web/AGENTS.md)
  150. - [api/AGENTS.md](../../api/AGENTS.md)
  151. ---
  152. ## Friends
  153. - [Linux.do](https://linux.do/) - Learn AI, on L Station.
  154. - [openai](https://openai.com/form/codex-for-oss/) - Thanks to the early OpenAI Developer Program for supporting this project.
  155. - [Aionui](https://github.com/iOfficeAI/AionUi) - Remotely control AI from your phone.
  156. - [OfficeCLI](https://github.com/iOfficeAI/OfficeCLI) - Office suite designed for AI Agents.
  157. - [deepseek-pp](https://github.com/zhu1090093659/deepseek-pp) - DeepSeek web chat browser extension.
  158. - [MuseAI](https://github.com/yejiming/MuseAI) - Local AI companion, text adventure, and interactive fiction app.
  159. - [FrontAgent](https://github.com/FrontAgent/FrontAgent) - AI Agent system designed for frontend engineering.
  160. - [RedBox](https://github.com/Jamailar/RedBox) - Localized AI creation workspace for Xiaohongshu creators.
  161. ---
  162. ## License
  163. This project is licensed under [Apache-2.0](./LICENSE).
  164. ---
  165. ## Contributors
  166. <p align="center">
  167. <a href="https://github.com/taichuy/1flowbase/graphs/contributors">
  168. <img src="https://contrib.rocks/image?repo=taichuy/1flowbase&max=50" alt="Contributors" />
  169. </a>
  170. </p>
  171. ---
  172. ## Star History
  173. <a href="https://www.star-history.com/?type=date&repos=taichuy%2F1flowbase">
  174. <picture>
  175. <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=taichuy/1flowbase&type=date&theme=dark&legend=top-left&sealed_token=FqLzVSU8-9DxFglG-qgV59WwozJJfOHYwvjWNeVtnDP8OJ8r8BwvdLCIloKkdrLXWJqUEaD9xkVSr0RkCvzGaIxDYXYX2Zz53ikx7xZkZckNqgevZkOi1A" />
  176. <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=taichuy/1flowbase&type=date&legend=top-left&sealed_token=FqLzVSU8-9DxFglG-qgV59WwozJJfOHYwvjWNeVtnDP8OJ8r8BwvdLCIloKkdrLXWJqUEaD9xkVSr0RkCvzGaIxDYXYX2Zz53ikx7xZkZckNqgevZkOi1A" />
  177. <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=taichuy/1flowbase&type=date&legend=top-left&sealed_token=FqLzVSU8-9DxFglG-qgV59WwozJJfOHYwvjWNeVtnDP8OJ8r8BwvdLCIloKkdrLXWJqUEaD9xkVSr0RkCvzGaIxDYXYX2Zz53ikx7xZkZckNqgevZkOi1A" />
  178. </picture>
  179. </a>
  180. ---
  181. <div align="center">
  182. **If you want Agents to build and operate self-hosted applications across AI, MCP, application backends, and React interfaces — give 1flowbase a Star.**
  183. [Report a Bug](https://github.com/taichuy/1flowbase/issues) · [Request a Feature](https://github.com/taichuy/1flowbase/issues)
  184. </div>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.