Skip to main content
Use this guide when you want to run Amika from source.

​
Prerequisites

  • Go 1.21 or later
  • Docker
  • macOS (primary supported contributor platform)
  • make
  • rsync

​
Build the binaries

git clone https://github.com/gofixpoint/amika.git
cd amika
make setup
make build
This build generates:
  • ./dist/amika (CLI)
  • ./dist/amika-server (HTTP API server)
Wrapper scripts also auto-build for local development: 
bin/amika --help
bin/amika-server

​
Verify Docker access

docker info

​
Run common commands

# Create a sandbox from current git repo
./dist/amika sandbox create --git --connect

# List tracked sandboxes and volumes
./dist/amika sandbox list
./dist/amika volume list

​
Run the HTTP API server

./dist/amika-server
By default, the server listens on :8080. To change the port: 
PORT=9090 ./dist/amika-server

​
Run development checks

make ci
Common individual targets: 
make build
make build-cli
make build-server
make test
make vet
make fmt
make lint
For detailed test pyramid and opt-in Docker test modes, see Development testing.

​
Troubleshooting

Confirm Docker Desktop is running and your user can access the Docker socket.
Remove the local preset image and rerun your command.
docker rmi amika/coder:latest
Open the CLI reference.
make lint uses revive and enforces doc comments for exported symbols.