InsForge

给编码智能体装上全套后端，一键从代码到上线。

开源 🏷️定价信息待确认 ✅ 目前可打开智能体 🍴 复刻 1249 🐛 待处理 267 👀 关注 34

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 13303

维护状态活跃

是否开源开源

定价模式 🏷️定价信息待确认

项目预览

项目数据

分类智能体

开发团队InsForge

官网地址https://insforge.dev

GitHubhttps://github.com/InsForge/InsForge

定价模式🏷️定价信息待确认

价格说明定价信息待确认

访问状态✅ 目前可打开

是否开源是

开源协议Apache-2.0

主要语言TypeScript

技术栈/模型ai,ai-agents,coding,deno,embeddings,insforge,nextjs,oauth2,pgvector,postgresql,realtime,vectors,websockets

GitHub 星标★ 13303

上线时间2025-07-29 00:00:00

代码更新2026-11-06

仓库体积150.4 MB

本站数据更新2026-11-08

维护状态活跃

收录时间2026-08-09

浏览次数5

项目介绍

InsForge 是一个开源的、面向智能体编程的全栈后端平台，旨在为 AI 编码智能体提供一站式基础设施。它整合了数据库（PostgreSQL + pgvector）、认证（OAuth2）、对象存储、计算资源、托管服务以及 AI 网关，使智能体能够直接构建和部署完整的全栈应用，而无需手动配置后端服务。项目基于 TypeScript 和 Deno 运行时，支持实时通信（WebSockets）和向量检索，特别适合需要长期记忆和语义搜索的智能体场景。通过提供统一的 API 和配置界面，InsForge 显著降低了智能体应用的后端开发门槛，让开发者可以专注于智能体逻辑本身，快速从原型走向生产。其核心价值在于将复杂的基础设施抽象化，赋予编码智能体自主完成端到端交付的能力。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 13303

技术标签

ai ai-agents coding embeddings nextjs

使用教程

难度：入门约 10 分钟部署方式：Docker 6 步

环境要求

已安装 Docker，并带 Compose v2
可写入用户主目录（如 ~/insforge）的权限
从源码构建时需要 Git
浏览器访问需能访问 .env 中配置的 API 地址

安装与启动步骤

1拉取部署文件

执行官方脚本，把部署所需文件下载到 ~/insforge，并自动生成 JWT_SECRET、ENCRYPTION_KEY、POSTGRES_PASSWORD、ROOT_ADMIN_PASSWORD 及两个访问密钥（.env 权限 600）。
```
curl -fsSL https://raw.githubusercontent.com/InsForge/InsForge/main/deploy/setup.sh | sh -s ~/insforge
```
2编辑 .env

进入部署目录编辑 .env，重点修改 API_BASE_URL 与 VITE_API_BASE_URL，即浏览器将访问的地址。重复执行 setup.sh 只会刷新文件并保留你已设置的值。
```
cd ~/insforge && $EDITOR .env
```
3启动服务

在部署目录直接执行 docker compose up -d。.env 中已设置 COMPOSE_FILE，因此无需再带 -f 参数。
```
cd ~/insforge && docker compose up -d
```
4验证安装

向你的编码智能体发送官方给出的提示词，让它调用 InsForge MCP 的 fetch-docs 工具了解 InsForge 使用说明，以确认后端连通。

5多项目隔离

每个项目用独立目录各跑一次 setup.sh，并在各自 .env 里设置不同的 COMPOSE_PROJECT_NAME 和端口；同名会共享容器，默认端口则会与 ~/insforge 实例冲突。

curl -fsSL https://raw.githubusercontent.com/InsForge/InsForge/main/deploy/setup.sh | sh -s ~/project1
curl -fsSL https://raw.githubusercontent.com/InsForge/InsForge/main/deploy/setup.sh | sh -s ~/project2
cd ~/project1 && docker compose up -d
cd ~/project2 && docker compose up -d

6源码构建（可选）

需要改动 InsForge 本身时使用。docker-compose.prod.yml 不会自动生成密钥，启动前必须自己在 .env 中设置 JWT_SECRET、ENCRYPTION_KEY、POSTGRES_PASSWORD、ROOT_
```
git clone https://github.com/InsForge/InsForge.git
cd InsForge
cp .env.example .env
$EDITOR .env
docker compose -f docker-compose.prod.yml up
```

关键配置

配置项	必填	说明	示例
`API_BASE_URL`	是	浏览器访问后端的地址，setup 后需自行修改	`https://api.example.com`
`VITE_API_BASE_URL`	是	前端使用的 API 地址，通常与 API_BASE_URL 一致	`https://api.example.com`
`COMPOSE_PROJECT_NAME`	是	Compose 项目名，默认 insforge；同名会共享容器	`project2`
`JWT_SECRET`	是	JWT 签名密钥，setup 脚本会自动生成	`自动生成的随机字符串`
`POSTGRES_PASSWORD`	是	PostgreSQL 数据库密码，setup 脚本会自动生成	`自动生成的随机字符串`
`ROOT_ADMIN_PASSWORD`	是	根管理员初始密码，setup 脚本会自动生成	`自动生成的随机字符串`

如何确认成功

向智能体发送提示词，让它调用 InsForge MCP 的 fetch-docs 工具获取说明；也可在部署目录执行 docker compose ps 查看容器状态。

常见问题

Q：重复运行 setup.sh 会覆盖我改过的配置吗？

A：不会。脚本只刷新文件、并保留你已经设置的所有值，最多只补充 COMPOSE_FILE，或把它指向当前 checkout 的 compose 文件。

Q：两个目录的实例为什么互相影响？

A：两份 .env 默认都是 COMPOSE_PROJECT_NAME=insforge，同名即共享容器，第二个 up -d 会接管第一个并按其配置重建。请为每个目录设置不同项目名和端口。

Q：本地不想装 Docker 怎么办？

A：README 提供一键部署入口：Railway、Zeabur、Sealos、RepoCloud 四种预配置方案，可直接在云端启动。

Q：浏览器打不开或连不上后端？

A：检查 .env 中的 API_BASE_URL 和 VITE_API_BASE_URL 是否为浏览器实际可访问的地址，改完需重新执行 docker compose up -d。

注意事项

setup.sh 只在目标目录生成 .env（权限 600），不会启动任何服务；启动由 docker compose up -d 完成。
多项目部署时默认端口会与 ~/insforge 实例冲突，需自行调整 POSTGRES_PORT、POSTGREST_PORT、APP_PORT、AUTH_PORT、DENO_PORT 等端口。
源码构建路径显式传 -f 会覆盖 COMPOSE_FILE；如需叠加配置，应继续追加 -f 参数而不是改该变量。
docker-compose.prod.yml 对未设置的变量会回退到已发布的默认值，任何对外暴露的实例都应自行设置好密钥。

核心亮点

内置 PGVector 向量库，智能体天然支持长期记忆与语义检索
集成 OAuth2 认证和实时 WebSocket，开箱即用省去后端配置
基于 Deno 和 TypeScript，类型安全且部署简单，适合现代云原生

不足之处

依赖 Deno 运行时，生态相对 Node.js 较小，迁移成本需评估
文档/社区待观察

适用场景

构建具备记忆能力的 AI 编程助手，自动管理项目数据和用户认证
快速搭建智能体驱动的 SaaS 应用，如自动生成后端接口的 MVP
在团队内搭建私有 AI 开发平台，统一管理智能体的存储和计算资源

替代项目

Supabase、PocketBase、Appwrite

上一篇：ephemeral-sandbox

下一篇：radar