Quick Start

Quick Start

Nothing installed → one command → aigate running. Not sure yet? Skim Home first. I wrote these pages so a spare evening is all you need; if a step feels muddy, tell me — that's a bug in the page, not in you.

What you need 🧰

Nothing. That's genuinely it. No Python to install first, no GPU, no special laptop, no compiler, no Docker, no cloud account.

You don't pay us anything — aigate is free and open source. The only thing that might cost money is the AI provider account you use, and some of those have free tiers.

Get it running ▶️

Clone it, step inside, run:

git clone https://github.com/fadhly-permata/AI-Gate
cd AI-Gate
bash scripts/bootstrap.sh

No git? GitHub's archive download works too — unzip and open a terminal in that folder first.

That line makes sure Python is there (installs it if it isn't), grabs the packages it needs, and starts the app. There's no separate install step; that step doesn't exist. First launch takes a moment.

Then the part everyone misses: the browser doesn't open itself. Type http://localhost:8080 and the page is just there.

The steps are the same on Windows — start it with powershell -File scripts\bootstrap.ps1 instead of the bash line. The terminal support Windows needs arrives on that first run, by itself.

On your phone 📱

Install Termux, then run the exact same command as on a laptop. Tested on real phones, including a full Linux distro on one.

One heads-up: the fiddly part on a phone isn't aigate, it's your coding tool. Android handles packages differently, so aigate notices it's in Termux and offers the install command that actually matches your device. CLI Tools covers that.

Port busy? Sharing a network? 🔌

If something already holds 8080, pick another port:

AIGATE_PORT=9090 bash scripts/bootstrap.sh

On Windows, set it first, then run the script: $env:AIGATE_PORT="9090"; pwsh scripts/bootstrap.ps1 in PowerShell, or set AIGATE_PORT=9090 in the old command prompt.

A quiet warning: aigate answers anyone on the same network — that's how your other devices reach it. So don't leave it running at a café or an airport.

Your first three minutes ✨

1. Open http://localhost:8080 in your browser.
2. Add the key or account of a provider you already have — here's where.
3. Choose that provider as the one to use.

Only then do the terminal, the coding tools, and the API come alive.

When something goes wrong 🧯

• A wall of unfamiliar text before anything starts? That's rarer now — the setup line handles Python for you. If it still couldn't find a way to install Python, tell me which OS you were on and what you saw; meanwhile, installing Python 3.10+ yourself and running again works too.
• Browser stayed empty? It never opens itself — type the address above.
• Address refused, or a port error? Use another port; the command is above.
• Page loads but nothing answers? You likely stopped before step 2 or 3 — a key added and a provider chosen. Still stuck, run it with the developer window and extra helpers:

AIGATE_DEV=1 bash scripts/bootstrap.sh

---