Skip to main content
MentatLab docs

Prerequisites

Getting Started

This guide gets MentatLab running locally with the Go services (gateway-go, orchestrator-go) and frontend.

Prerequisites

  • Go 1.23+
  • Node.js 20+
  • npm
  • Docker (for Redis / compose workflow)

Option 1: Full Stack via Docker Compose

docker-compose up

Default service endpoints:

  • Frontend: http://localhost:5173
  • Gateway: http://localhost:8080
  • Orchestrator: http://localhost:7070
  • Redis: localhost:6379

Option 2: Run Services Manually

  1. Start Redis:
docker run --rm -p 6379:6379 redis:7-alpine
  1. Start Orchestrator:
cd services/orchestrator-go
go run ./cmd/orchestrator/
  1. Start Gateway:
cd services/gateway-go
go run main.go
  1. Start Frontend:
cd services/frontend
npm install
npm run dev

Smoke Checks

curl http://localhost:8080/healthz
curl http://localhost:7070/healthz
curl http://localhost:7070/ready

Common Dev Commands

# root quick check
make check

# Go service tests
cd services/orchestrator-go && go test -v ./...
cd services/gateway-go && go test -v ./...

# frontend checks
cd services/frontend && npm test
cd services/frontend && npm run lint

Next: review Architecture and API Reference.