InsForge InsForge

InsForge

面向 AI 原生开发者的后端平台。⭐ 帮助我们触达更多开发者，壮大 InsForge 社区。请为本仓库点星！

InsForge 是一个专为 AI 编码代理（AI coding agents）和 AI 代码编辑器构建的后端开发平台。它通过一个语义层（semantic layer）暴露数据库、认证、存储和函数等后端原语，使得代理能够理解、推理并端到端地操作这些原语。

InsForge-readme.mp4

工作原理

InsForge 充当 AI 编码代理与后端原语之间的语义层。它执行后端上下文工程（backend context engineering），使代理能够理解、操作和检查后端系统。

• 获取后端上下文：代理可以获取其所用后端原语的文档和可用操作。
• 配置原语：代理可以直接配置后端原语。
• 检查后端状态：后端状态和日志通过结构化模式（structured schemas）暴露。

graph TB
    subgraph TOP[" "]
        AG[AI Coding Agents]
    end
    subgraph MID[" "]
        SL[InsForge Semantic Layer]
    end
    AG --> SL
    SL --> AUTH[Authentication]
    SL --> DB[Database]
    SL --> ST[Storage]
    SL --> EF[Edge Functions]
    SL --> MG[Model Gateway]
    SL --> CP[Compute]
    SL --> DEP[Deployment]
    classDef bar fill:#0b0f14,stroke:#30363d,stroke-width:1px,color:#ffffff
    classDef card fill:#161b22,stroke:#30363d,stroke-width:1px,color:#ffffff
    class AG,SL bar
    class AUTH,DB,ST,EF,MG,CP,DEP card
    style TOP fill:transparent,stroke:transparent
    style MID fill:transparent,stroke:transparent
    linkStyle default stroke:#30363d,stroke-width:1px

加载中

核心产品

• Authentication：用户管理、认证和会话
• Database：Postgres 关系型数据库
• Storage：兼容 S3 的文件存储
• Model Gateway：跨多个 LLM 提供商的 OpenAI 兼容 API
• Edge Functions：在边缘运行的无服务器代码
• Compute（私有预览）：在 Fly.io 上运行的长期容器服务，带有公共 URL（[文档](https://docs.insforge.dev)）
• Site Deployment：站点构建与部署

⭐️ 为仓库点星

如果你觉得 InsForge 有用或有趣，我们将非常感谢你在 GitHub 上点一个星 ⭐️。

快速开始

• 云托管：insforge.dev
• 自托管：Docker Compose
• 前提条件：Docker + Node.js

1. 设置

你可以使用 Docker Compose 在本地运行 InsForge。这将在你的机器上启动一个本地 InsForge 实例。

或者从源码运行：

# 使用 Docker 运行
git clone https://github.com/insforge/insforge.git
cd insforge
cp .env.example .env
docker compose -f docker-compose.prod.yml up

2. 连接 InsForge MCP

打开 http://localhost:7130

按照步骤连接 InsForge MCP 服务器

3. 验证安装

要验证连接，请向你的代理发送以下提示：

我正在使用 InsForge 作为我的后端平台，请调用 InsForge MCP 的 fetch-docs 工具来了解 InsForge 的使用说明。

4. 运行多个项目

你可以通过使用不同的端口和项目名称，在同一主机上运行多个 InsForge 项目。

# 为每个项目创建独立的 env 文件
cp .env.example .env.project1
cp .env.example .env.project2

编辑 .env.project2，使用不同的端口：

POSTGRES_PORT=5442
POSTGREST_PORT=5440
APP_PORT=7230
AUTH_PORT=7231
DENO_PORT=7233

使用唯一的名称启动每个项目：

docker compose -f docker-compose.prod.yml --env-file .env.project1 -p project1 up -d
docker compose -f docker-compose.prod.yml --env-file .env.project2 -p project2 up -d

每个项目都有自己独立的数据库、存储和配置。使用以下命令管理它们：

docker compose -f docker-compose.prod.yml --env-file .env.project1 -p project1 ps        # 状态
docker compose -f docker-compose.prod.yml --env-file .env.project1 -p project1 logs -f   # 日志
docker compose -f docker-compose.prod.yml --env-file .env.project1 -p project1 down      # 停止

一键部署

除了在本地运行 InsForge，你还可以使用预配置的部署方案快速启动 InsForge，无需在本地机器上安装 Docker。

• Railway
• Zeabur
• Sealos

贡献

• 贡献：如果你有兴趣贡献，可以查看我们的指南 [CONTRIBUTING.md](https://github.com/insforge/insforge/blob/main/CONTRIBUTING.md)。我们非常欢迎 Pull Request，所有形式的帮助都值得感谢！
• 支持：如果你需要任何帮助或支持，我们在 [Discord 频道](https://discord.gg/insforge) 上响应迅速，也欢迎发送邮件至 info@insforge.dev！

文档与支持

• 文档：[官方文档](https://docs.insforge.dev) - 全面的指南和 API 参考
• 社区：[Discord](https://discord.gg/insforge) - 加入我们活跃的社区
• Twitter：关注我们获取更新和技巧
• 联系：邮箱：info@insforge.dev

许可证

本项目基于 Apache License 2.0 许可 - 详见 [LICENSE](https://github.com/insforge/insforge/blob/main/LICENSE) 文件。

徽章

展示你的项目是用 InsForge 构建的。

Made with InsForge

Markdown：

[![Made with InsForge](https://insforge.dev/badge-made-with-insforge.svg)](https://insforge.dev)

HTML：

Made with InsForge (dark)

Markdown：

[![Made with InsForge](https://insforge.dev/badge-made-with-insforge-dark.svg)](https://insforge.dev)

HTML：

⭐ 在 GitHub 上为我们点星，以便在新版本发布时收到通知！