InsForge / InsForge
InsForge / InsForge
The backend platform for AI-native developers. ⭐ Help us reach more developers and grow the InsForge community. Star this repo! 专为 AI 原生开发者打造的后端平台。⭐ 帮助我们触达更多开发者并壮大 InsForge 社区,请为本项目点亮 Star!
InsForge is a backend development platform built for AI coding agents and AI code editors. It exposes backend primitives like databases, auth, storage, and functions through a semantic layer that agents can understand, reason about, and operate end to end. InsForge 是一个专为 AI 编程智能体(AI coding agents)和 AI 代码编辑器构建的后端开发平台。它通过一个语义层将数据库、身份验证、存储和函数等后端基础组件暴露出来,使智能体能够理解、推理并端到端地操作这些组件。
How it works
工作原理
InsForge acts as a semantic layer between AI coding agents and backend primitives. It performs backend context engineering so agents can understand, operate, and inspect backend systems. InsForge 在 AI 编程智能体与后端基础组件之间充当语义层。它执行后端上下文工程,以便智能体能够理解、操作和检查后端系统。
- Fetch backend context: Agents can fetch documentation and available operations for the backend primitives they use.
- Configure primitives: Agents can configure backend primitives directly.
- Inspect backend state: Backend state and logs are exposed through structured schemas.
- 获取后端上下文: 智能体可以获取其所使用的后端基础组件的文档和可用操作。
- 配置基础组件: 智能体可以直接配置后端基础组件。
- 检查后端状态: 后端状态和日志通过结构化模式(Schema)进行暴露。
Core Products:
核心产品:
- Authentication: User management, authentication, and sessions
- Database: Postgres relational database
- Storage: S3 compatible file storage
- Model Gateway: OpenAI compatible API across multiple LLM providers
- Edge Functions: Serverless code running on the edge
- Compute (private preview): Long-running container services on Fly.io with public URLs
- Site Deployment: Site build and deployment
- 身份验证: 用户管理、身份验证和会话。
- 数据库: Postgres 关系型数据库。
- 存储: 兼容 S3 的文件存储。
- 模型网关: 跨多个 LLM 提供商的 OpenAI 兼容 API。
- 边缘函数: 在边缘运行的无服务器代码。
- 计算(内测中): 在 Fly.io 上运行的、带有公共 URL 的长驻容器服务。
- 站点部署: 站点构建与部署。
⭐️ Star the Repository
⭐️ 为仓库点赞
If you find InsForge useful or interesting, a GitHub Star ⭐️ would be greatly appreciated. 如果您觉得 InsForge 有用或有趣,非常感谢您能为我们在 GitHub 上点亮一颗 Star ⭐️。
Quickstart
快速开始
Cloud-hosted: insforge.dev Self-hosted: Docker Compose 云托管: insforge.dev 自托管: Docker Compose
Prerequisites: Docker + Node.js 前置条件: Docker + Node.js
1. Setup
1. 设置
You can run InsForge locally using Docker Compose. This will start a local InsForge instance on your machine. Or run from source: 您可以使用 Docker Compose 在本地运行 InsForge。这将在您的机器上启动一个本地 InsForge 实例。或者从源码运行:
# Run with Docker
git clone https://github.com/insforge/insforge.git
cd insforge
cp .env.example .env
docker compose -f docker-compose.prod.yml up
2. Connect InsForge MCP
2. 连接 InsForge MCP
Open http://localhost:7130. Follow the steps to connect InsForge MCP Server.
打开 http://localhost:7130,按照步骤连接 InsForge MCP 服务器。
3. Verify installation
3. 验证安装
To verify the connection, send the following prompt to your agent: I’m using InsForge as my backend platform, call InsForge MCP’s fetch-docs tool to learn about InsForge instructions. 要验证连接,请向您的智能体发送以下提示词: I’m using InsForge as my backend platform, call InsForge MCP’s fetch-docs tool to learn about InsForge instructions.
4. Running Multiple Projects
4. 运行多个项目
You can run multiple InsForge projects on the same host by using different ports and project names. 您可以通过使用不同的端口和项目名称,在同一台主机上运行多个 InsForge 项目。
Each project gets its own isolated database, storage, and configuration. 每个项目都有其独立的数据库、存储和配置。
One-click Deployment
一键部署
In addition to running InsForge locally, you can also launch InsForge using a pre-configured setup. This allows you to get up and running quickly with InsForge without installing Docker on your local machine. 除了在本地运行 InsForge 外,您还可以使用预配置的设置来启动 InsForge。这使您无需在本地机器上安装 Docker 即可快速上手 InsForge。
(Supported platforms: Railway, Zeabur, Sealos) (支持平台:Railway, Zeabur, Sealos)
Contributing
贡献
If you’re interested in contributing, you can check our guide here CONTRIBUTING.md. We truly appreciate pull requests, all types of help are appreciated!
如果您有兴趣参与贡献,请查看我们的指南 CONTRIBUTING.md。我们非常欢迎 Pull Requests,任何形式的帮助我们都深表感谢!
Documentation & Support
文档与支持
- Official Docs: Comprehensive guides and API references
- Community Discord: Join our vibrant community
- Twitter: Follow for updates and tips
- Contact Email: info@insforge.dev
- 官方文档: 全面的指南和 API 参考。
- 社区 Discord: 加入我们活跃的社区。
- Twitter: 关注以获取更新和技巧。
- 联系邮箱: info@insforge.dev
License
许可证
This project is licensed under the Apache License 2.0 - see the LICENSE file for details. 本项目采用 Apache License 2.0 许可证 - 详情请参阅 LICENSE 文件。
⭐ Star us on GitHub to get notified about new releases! ⭐ 在 GitHub 上关注我们,获取新版本发布通知!