The backend platform for AI-native developers.

⭐ Help us reach more developers and grow the InsForge community. Star this repo!

InsForge

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.

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.

• 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.

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

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 (docs)
• Site Deployment: Site build and deployment

⭐️ Star the Repository

If you find InsForge useful or interesting, a GitHub Star ⭐️ would be greatly appreciated.

Quickstart

Cloud-hosted: insforge.dev

Self-hosted: Docker Compose

Prerequisites: Docker + Node.js

1. Setup

You can run InsForge locally using Docker Compose. This will start a local InsForge instance on your machine.

Or run from source:

# 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

Open http://localhost:7130

Follow the steps to connect InsForge MCP Server

3. Verify installation

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.

4. Running Multiple Projects

You can run multiple InsForge projects on the same host by using different ports and project names.

# Create a separate env file for each project
cp .env.example .env.project1
cp .env.example .env.project2

Edit .env.project2 with different ports:

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

Start each project with a unique name:

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

Each project gets its own isolated database, storage, and configuration. Manage them with:

docker compose -f docker-compose.prod.yml --env-file .env.project1 -p project1 ps      # status
docker compose -f docker-compose.prod.yml --env-file .env.project1 -p project1 logs -f  # logs
docker compose -f docker-compose.prod.yml --env-file .env.project1 -p project1 down     # stop

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.

Railway	Zeabur	Sealos

Contributing

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!

Support: If you need any help or support, we're responsive on our Discord channel, and also feel free to email us info@insforge.dev too!

Documentation & Support

Documentation

• Official Docs - Comprehensive guides and API references

Community

• Discord - Join our vibrant community
• Twitter - Follow for updates and tips

Contact

• Email: info@insforge.dev

License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

Badges

Show your project is built with InsForge.

Made with InsForge

Markdown:

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

HTML:

<a href="https://insforge.dev">
  <img
    width="168"
    height="30"
    src="https://insforge.dev/badge-made-with-insforge.svg"
    alt="Made with InsForge"
  />
</a>

Made with InsForge (dark)

Markdown:

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

HTML:

<a href="https://insforge.dev">
  <img
    width="168"
    height="30"
    src="https://insforge.dev/badge-made-with-insforge-dark.svg"
    alt="Made with InsForge"
  />
</a>

⭐ Star us on GitHub to get notified about new releases!