Documentation
How Bnome Works
Under the hood of AI-powered app generation. From text description to a live, fully functional web application.
On this page
Overview
Bnome is an AI platform that generates fully functional web applications from a text description. You describe what you want — and within minutes, you get a working app with its own URL, backend API, database, and frontend interface.
No templates, no drag-and-drop, no boilerplate. An AI agent writes real code, installs dependencies, builds the project, and deploys it — all autonomously.
~2 min
Average deploy time
100%
Real, custom code
1 click
From idea to live app
How It Works
The entire journey from idea to a live application takes three steps. No configuration, no deployment setup, no DevOps knowledge required.
1
Describe your app
Write a natural language description of what you need. "Build a habit tracker with daily streaks and weekly analytics" — that's all it takes.
2
AI generates everything
Our AI agent analyzes your request, designs the architecture, writes frontend and backend code, installs dependencies, configures the database, and builds the project.
3
Get your live URL
Your app is deployed to its own subdomain with HTTPS. Share the link, start using it immediately. No waiting, no manual steps.
Architecture
Every application generated by Bnome runs in its own isolated environment. There's no shared runtime, no multi-tenant backend — each app is a standalone full-stack deployment.
Isolated containers
Each app runs in a dedicated container with its own filesystem, processes, and network namespace. Complete isolation between applications.
Full-stack per app
Every generated app includes a backend API server, frontend interface, and its own database. No shared state between apps.
Individual URLs
Each app gets a unique subdomain with HTTPS. Direct access, no authentication required to view public apps.
AI Agent
The core of Bnome is an autonomous AI agent that doesn't just generate code — it builds, tests, and deploys a complete application through an iterative process.
Unlike template-based tools, our agent makes real-time decisions about architecture, design patterns, and implementation. Every app is unique and purpose-built.
Agent capabilities
Write code
Creates frontend components, backend endpoints, database models, utilities — any file your app needs
Install packages
Determines which npm and pip packages are needed and installs them automatically
Execute commands
Runs build scripts, database migrations, and any shell commands required for the app
Read & analyze
Reviews existing code to understand the project structure before making changes
Build & deploy
Compiles the frontend, starts the backend, and verifies everything works together
Iterate on errors
If something fails, the agent reads the error, diagnoses the issue, and fixes it autonomously
Isolation & Security
Security is fundamental to Bnome's architecture. Every user application runs in a sandboxed environment with strict resource limits and capability restrictions.
Container sandboxing
Each app runs in an isolated container with a minimal capability set. No access to the host filesystem, network configuration, or other applications.
Resource limits
Strict memory and CPU limits per container prevent any single application from affecting platform performance or other users.
Network isolation
Applications communicate through a controlled network layer. No direct container-to-container access. All external traffic passes through our proxy.
SSL everywhere
Every application URL is served over HTTPS with automatically provisioned SSL certificates. No exceptions.
Container isolation
Memory limits
CPU limits
Capability restrictions
HTTPS
Path traversal protection
Tech Stack
Bnome uses a modern, production-ready stack. The platform itself and every generated application are built with industry-standard technologies.
What your app gets
React frontend
Modern React with Tailwind CSS for styling. Responsive design, dark theme, production-optimized build.
Python API backend
FastAPI-powered backend with automatic API documentation. Async by default, high performance.
Built-in database
Each app has its own database for persistent storage. Full CRUD operations, relationships, migrations.
Authentication
User authentication system with secure password hashing, JWT tokens, and session management — built in when needed.
React
FastAPI
Tailwind CSS
Docker
PostgreSQL
Nginx
Beyond CRUD
Most AI code generators produce frontend interfaces with mock data or simple CRUD operations. Bnome is fundamentally different — every app gets a persistent server process with a real backend that runs continuously.
What makes Bnome different
Persistent backend processes
Your Python backend runs 24/7 inside the container. It can execute scheduled tasks, run background computations, serve API requests, and maintain long-running connections.
Real databases
Not localStorage. Not JSON files. Each app gets a proper database with tables, relationships, indexes, and SQL queries. Data persists, supports concurrent access, and scales.
External API integrations
Your app can call any external API — fetch exchange rates, pull data from third-party services, send webhooks. The backend has full network access and can run HTTP clients.
Multi-step workflows
Build apps with complex business logic: data pipelines, transformation chains, approval workflows, automated report generation. Not just forms and lists.
This is the fundamental difference: Bnome builds software that runs, not pages that render. Your application is a living system with a backend, a database, and the ability to interact with the outside world on its own.
Background jobs
Scheduled tasks
Data pipelines
External APIs
File generation
Live URLs
Every application generated by Bnome immediately gets its own live URL on a unique subdomain. No deployment configuration, no DNS setup, no hosting management.
The platform handles SSL certificate provisioning, DNS resolution, and traffic routing automatically. When a user visits your app's URL, the request is routed through our proxy layer directly to your application's container.
HTTPS
Auto-provisioned SSL
*.bnome
Wildcard subdomains
0 config
Zero deployment setup
Modifications
Your app isn't frozen after generation. Bnome supports iterative modifications through a chat interface. Describe what you want to change — the AI agent modifies the existing codebase, preserving everything that works.
1
Describe the change
"Add a dark mode toggle to the settings page" or "Replace the pie chart with a bar chart on the dashboard" — any modification in plain language.
2
AI modifies existing code
The agent reads your current codebase, understands the structure, and makes targeted changes. No full regeneration — only what needs to change is modified.
3
Instant update
Changes are applied, the app is rebuilt, and your live URL reflects the update immediately.
The modification system understands context. It knows your app's file structure, dependencies, and design patterns. Each modification builds on the previous state, allowing you to iteratively refine your application through conversation.
Iterative
Context-aware
Non-destructive
Instant deploy