Skip to content

wrtnlabs/autobe

Repository files navigation

AutoBE - AI backend builder for prototype to production

GitHub License NPM Version NPM Downloads Build Status Guide Documents Discord Badge

Describe your backend requirements in natural language through AutoBE's chat interface.

AutoBE will analyze your requirements and build the backend application for you. The generated backend application is designed to be 100% buildable by AI-friendly compilers and ensures stability through powerful e2e test functions.

With such AutoBE, build your first backend application quickly, then maintain and extend it with AI code assistants like Claude Code for enhanced productivity and stability.

AutoBE will generate complete specifications, detailed database and API documentation, comprehensive test coverage for stability, and clean implementation logic that serves as a learning foundation for juniors while significantly improving senior developer productivity.

Check out these complete backend application examples generated by AutoBE:

720p.mp4
  1. Discussion Board: https://github.com/wrtnlabs/autobe-example-bbs
  2. To Do List: https://github.com/wrtnlabs/autobe-example-todo
  3. Reddit Community: https://github.com/wrtnlabs/autobe-example-reddit
  4. E-Commerce: https://github.com/wrtnlabs/autobe-example-shopping

Getting Started

Playground StackBlitz

https://stackblitz.com/github/wrtnlabs/autobe-playground-stackblitz

Visit the site above to use AutoBE directly through the StackBlitz website. Simply discuss the topic you want to build, and AutoBE will create a backend application for you.

Here's an example conversation script to use with AutoBE. Following this script will guide AutoBE to create an "Economic/Political Discussion Board":

  1. Requirements Analysis: "I want to create an economic/political discussion board. Since I'm not familiar with programming, please write a requirements analysis report as you see fit."
  2. Database Design: "Design the database schema."
  3. API Specification: "Create the API interface specification."
  4. Testing: "Make the e2e test functions."
  5. Implementation: "Implement API functions."

If you want to use Local LLMs like qwen3-80b-a3b or maintain multiple chat sessions for frequent conversations with AutoBE, run the following commands. You can install AutoBE locally, run the playground application directly, and manage your chat sessions:

git clone https://github.com/wrtnlabs/autobe
cd autobe
pnpm install
pnpm run playground

Compilation Success Dashboard

After installing AutoBE locally and running the playground, you can replay chat sessions from AutoBE development team's testing at http://localhost:5713/replay/index.html.

Documentation Resources

Find comprehensive resources at our official website.

🏠 Home

πŸ“– Features

πŸ”— Appendix

How AutoBE Works

flowchart
subgraph "Backend Coding Agent"
  coder("Facade Controller")
end
subgraph "Functional Agents"
  coder --"Requirements Analysis"--> analyze("Analyze")
  coder --"ERD"--> prisma("Prisma")
  coder --"API Design"--> interface("Interface")
  coder --"Test Codes" --> test("Test")
  coder --"Main Program" --> realize("Realize")
end
subgraph "Compiler Feedback"
  prisma --"validates" --> prismaCompiler("<a href="https://github.com/wrtnlabs/autobe/blob/main/packages/interface/src/prisma/AutoBePrisma.ts" target="_blank">Prisma Compiler</a>")
  interface --"generates" --> openapiCompiler("<a href="https://github.com/wrtnlabs/autobe/blob/main/packages/interface/src/openapi/AutoBeOpenApi.ts" target="_blank">OpenAPI Compiler</a>")
  test --"analyzes" --> testCompiler("<a href="https://github.com/wrtnlabs/autobe/blob/main/packages/interface/src/test/AutoBeTest.ts" target="_blank">Test Compiler</a>")
  realize --"compiles" --> realizeCompiler("TypeScript Compiler")
end
Loading

AutoBE follows a waterfall methodology to generate backend applications, with 40+ specialized agents handling each phase. The agents work in coordinated teams throughout the development process.

Each waterfall stage includes AI-friendly compilers that guarantee type safety of the generated code. Rather than generating code directly, AutoBE's agents first construct language-neutral Abstract Syntax Trees using predefined schemas. Each AST node undergoes validation against type rules before any code generation occurs, catching structural errors at the conceptual level rather than during compilation.

This approach is designed to ensure that the final generated TypeScript and Prisma code is 100% buildable. Based on our testing with multiple example projects including e-commerce platforms, discussion boards, and task management systems, AutoBE maintains this compilation guarantee across diverse application types.

To illustrate this process, here are the phase outputs from our "Economic/Political Discussion Board" example:

  1. Requirements Analysis: Report
  2. Database Design: Entity Relationship Diagram / Prisma Schema
  3. API Specification: API Controllers / DTO Structures
  4. E2E Test Functions: test/features/api
  5. API Implementations: src/providers

Also, you don't need to use all phases - stop at any stage that fits your needs. Whether you want just requirements analysis, database design, API specification, or e2e testing, AutoBE adapts to your workflow.

Additionally, if you're skipping the full pipeline because of language preference rather than workflow needs, this capability is in development - AutoBE's language-neutral AST structure will soon support additional programming languages beyond TypeScript.

Type-Safe Client SDK

Every AutoBE-generated backend automatically includes a type-safe client SDK, making frontend integration seamless and error-free. This SDK provides:

  • Zero Configuration: SDK is auto-generated alongside your backend - no manual setup required
  • 100% Type Safety: Full TypeScript support with autocomplete and compile-time validation
  • Framework Agnostic: Works with React, Vue, Angular, or any TypeScript/JavaScript project
  • E2E Test Integration: Powers AI-generated test suites for comprehensive backend testing
import api, { IPost } from "autobe-generated-sdk";

// Type-safe API calls with full autocomplete
const connection: api.IConnection = {
  host: "http://localhost:1234",
};
await api.functional.users.login(connection, {
  body: {
    email: "user@example.com",
    password: "secure-password",
  },
});

// TypeScript catches errors at compile time
const post: IPost = await api.functional.posts.create(connection, {
  body: {
    title: "Hello World",
    content: "My first post",
    // authorId: "123" <- TypeScript error if this field is missing!
  },
});

This SDK eliminates the traditional pain points of API integration - no more manual type definitions, no more runtime surprises, and no more API documentation lookups. Your frontend developers can focus on building features, not wrestling with API contracts.

Beyond Frontend Integration: The SDK powers both frontend development and E2E test generation. AutoBE uses the same type-safe SDK internally to generate comprehensive test suites, ensuring every API endpoint is thoroughly tested. This creates a robust feedback loop that enhances backend stability - AI writes tests using the SDK, the SDK ensures type safety, and your backend becomes more reliable with every generated test.

Roadmap Schedule

gantt
  dateFormat YYYY-MM-DD
  title AutoBE Roadmap Overview

  section Alpha Release
  Overall Design: done, 2025-05-01, 21d
  Compiler Development: done, 2025-05-16, 30d
  Prototype Agents: done, 2025-05-16, 30d

  section Beta Release
  Compiler Feedback: done, 2025-06-15, 29d
  Test Agent: done, 2025-06-15, 92d
  Realize Agent: done, 2025-07-01, 76d
  Achieve 100% Compilation: done, 2025-07-16, 61d
  Hackathon Contest: done, 2025-09-01, 21d

  section v1.0 Official Release
  Debate Enhancement: planned, 2025-09-15, 90d
  RAG Optimization: planned, 2025-09-15, 90d
  Achieve 100% Working: active, 2025-09-15, 90d
Loading

AutoBE has successfully completed both Alpha and Beta development phases, establishing a solid foundation for production-ready backend generation.

The Alpha phase (May 2025) focused on core architecture design and compiler development, creating the foundational framework for AI-friendly code generation. We built the initial agent system and established the waterfall methodology that ensures reliable, structured development processes.

The Beta phase (June 15 - September 14, 2025) achieved our primary goal: 100% compilation success rate. Through extensive testing across diverse application types including e-commerce platforms, discussion boards, and task management systems, we validated that AutoBE's AI-friendly compilers can generate TypeScript and Prisma code that compiles successfully every time.

The v1.0 Official Release (starting September 15, 2025) now targets the next milestone: ensuring that AutoBE-generated backend applications not only compile successfully, but also run perfectly in production environments. This means achieving 100% runtime success alongside our existing compilation guarantee, delivering truly production-ready applications without manual intervention.

Current Limitations

While AutoBE achieves 100% compilation success, please note these current limitations:

Runtime Behavior: Generated applications compile successfully, but runtime behavior may require testing and refinement. Unexpected runtime errors can occur during server execution, such as database connection issues, API endpoint failures, or business logic exceptions that weren't caught during compilation. We strongly recommend thorough testing in development environments before deploying to production. Our v1.0 release targets 100% runtime success to address these issues.

Design Interpretation: AutoBE's database and API designs may differ from your expectations. We recommend thoroughly reviewing generated specifications before proceeding with implementation, especially before production deployment.

Token Consumption: AutoBE requires significant AI token usage for complex projects. Based on our testing, projects typically consume 30M-250M+ tokens depending on complexity (simple todo apps use ~4M tokens, while complex e-commerce platforms may require 250M+ tokens). We are working on RAG optimization to reduce this overhead in future releases.

Maintenance: AutoBE focuses on initial generation and does not provide ongoing maintenance capabilities. Once your backend is generated, you'll need to handle bug fixes, feature additions, performance optimizations, and security updates manually. We recommend establishing a development workflow that combines the generated codebase with AI coding assistants like Claude Code for efficient ongoing development and maintenance tasks.

Entity Relationship Diagram Sample

License

AutoBE is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0). If you modify AutoBE itself or offer it as a network service, you must make your source code available under the same license.

However, backend applications generated by AutoBE can be relicensed under any license you choose, such as MIT. This means you can freely use AutoBE-generated code in commercial projects without open source obligations, similar to how other code generation tools work.