Quickstart
Quickstart Guide
Choose the quickest way to get started based on your workflow.
Method 1: Live Demo (Instant Try)
You can try the online demo hosted on Cloudflare Pages without installing anything: 👉 Live Demo
- Click the Settings icon in the upper right corner.
- Enter your Google Gemini API Key under Providers & API.
- Start chatting immediately! All data is stored in your local browser.
Method 2: Local Development
Prerequisites
- Node.js: Recommended Node.js 26 (
.nvmrcprovided in repo), minimum Node.js 24. - Package Manager: pnpm 11+.
# 1. Clone the repositorygit clone https://github.com/yeahhe365/AMC-WebUI.gitcd AMC-WebUI
# 2. Use recommended Node versionnvm use
# 3. Install dependenciespnpm install
# 4. Start development serverpnpm devCreate a .env.local in the project root:
VITE_GEMINI_API_KEY=AIzaSyYourGeminiApiKeyVITE_OPENAI_API_KEY=sk-YourOpenAiKeyVisit http://localhost:5175 in your browser.
Method 3: Docker Compose (Recommended for Self-Hosting)
# 1. Build frontend & backend artifactspnpm run build:docker
# 2. Launch containersdocker compose up -d --build- Accessible at
http://localhost:8080. - Stop anytime with
docker compose down.