Introduction
Aero starts as a clean Go service with a Cobra CLI, a Gin server, server-rendered pages, and GORM-managed models backed by SQLite or Postgres. This page covers running it locally and how the pieces fit together.
Quickstart
Build the binary, start the server in debug mode, and hit the health check.
go build -o bin/aero ./cmd/aero
./bin/aero server --debug -p 8080
curl http://localhost:8080/api/healthcheckTip: Run with --debug for verbose logs and the dev-only login route.
Included routes
- GET / — the home page.
- GET /docs — developer documentation.
- GET /features — product feature pages.
- GET /guides — step-by-step walkthroughs.
- GET /pricing — plans.
- GET /sign-in — the auth UI scaffold.
- GET /download — installation.
Key concepts
- Data model — users own skills, tags are shared public labels, and skill_tags links each skill to its labels. MCP entries define external tool connections.
- Auth surface — start from /api/v1/auth and /api/v1/oauth/google for email and OAuth flows.
Config
Use config.toml to set the server port, debug mode, SQLite path, or Postgres connection URL used during startup.