Bot Builder documentation

Your bot, your files, your runtime.

Bot Builder creates a portable Python project from a validated configuration and a maintained runtime. Agent Media Tools does not host its conversations, model credentials, or memory.

Open Bot Builder Quick start

Secrets are never included.

The ZIP contains an empty .env.example. Add model keys, Discord or Telegram tokens, and optional AMT keys only after downloading.

Quick start

Describe the bot in Easy mode or open Advanced mode.
Choose its interface, model provider, memory, knowledge, tools, and deployment target.
Download and extract the ZIP.
Copy .env.example to .env and add only the credentials you need.
Run the Windows or Linux launcher, or build the included Docker image.

unzip my-bot.zip
cd my-bot
cp .env.example .env
# edit .env privately
./start-linux.sh

Choose your next guide

Setup & first run

Prerequisites, private environment configuration, isolated installation, diagnostics, first reply, and Docker rehearsal.

Setup runbook →

Platforms

Terminal, local web chat, Discord application setup, and Telegram BotFather.

Platform guide →

Model providers

OpenAI, Anthropic, Gemini, Ollama, LM Studio, OpenWebUI, and compatible endpoints.

Provider guide →

Deployment

Docker, VPS, DigitalOcean, Railway, Render, Fly.io, Tailscale, verification, and rollback.

Deployment runbook →

AMT tools

Give the downloaded bot an explicit allowlist for media, web, OCR, PDF, and QR work.

Integration guide →

Projects and updates

Downloads work without an account. Signed-in users can save configurations privately, update them, and inspect version history. Exported config.json files can be imported later; older supported schemas are normalized to the current schema. Knowledge-file contents are packaged into a single download and are not stored with a saved project.

Import configuration, not secrets.

Bot Builder accepts its versioned config.json. It does not need or accept the private .env from an existing bot.

What the ZIP contains

File	Purpose
`bot.py`	Maintained runtime and selected platform adapter.
`config.json`	Validated, portable bot configuration.
`.env.example`	Secret-free list of supported environment variables.
`requirements.txt`	Pinned Python dependencies for the selected platform.
`knowledge/`	Trusted text knowledge packaged by the user.
`Dockerfile`, `docker-compose.yml`	Container build and persistent memory volume.
`railway.json`, `render.yaml`, `fly.toml`, `.do/app.yaml`	Provider-specific starting manifests that must be reviewed before deployment.

← Open builder Platforms →