Building from Source

Compile Alita Robot from source code.

Build Alita Robot from source for development, customization, or when pre-built binaries are not available for your platform.

Prerequisites

Install Go

brew install go

sudo snap install go --classic

Install golangci-lint

brew install golangci-lint

curl -sSfL https://raw.githubusercontent.com/golangci/golangci-lint/master/install.sh | sh -s -- -b $(go env GOPATH)/bin

go install github.com/golangci/golangci-lint/v2/cmd/golangci-lint@v2.14.0

Clone the Repository

git clone https://github.com/divkix/Alita_Robot.git
cd Alita_Robot

Build Commands

Development Build

Run the bot directly from source:

# Using Make
make run

# Or using Go directly
go run main.go

Production Build

go install github.com/goreleaser/goreleaser/v2@latest

make build

Manual Build

Build for your current platform:

go build -o alita_robot .

Cross-compile for other platforms:

# Linux amd64
GOOS=linux GOARCH=amd64 go build -o alita_robot_linux_amd64 .

# macOS arm64
GOOS=darwin GOARCH=arm64 go build -o alita_robot_darwin_arm64 .

# Windows amd64
GOOS=windows GOARCH=amd64 go build -o alita_robot_windows_amd64.exe .

Makefile Targets

Code Quality

Run Linter

make lint

This runs golangci-lint with the project’s configuration. Fix any issues before committing.

Check Dependencies

make tidy

This:

• Removes unused dependencies
• Downloads missing dependencies
• Updates go.sum checksums

Project Structure

Alita_Robot/
├── main.go              # Entry point
├── go.mod               # Go module definition
├── go.sum               # Dependency checksums
├── Makefile             # Build automation
├── .goreleaser.yaml     # GoReleaser configuration
├── sample.env           # Example environment file
├── docker-compose.yml   # Docker Compose configuration
├── .dockerignore          # Docker ignore rules
├── debug.docker-compose.yml # Debug compose configuration
├── alita/               # Main application code
│   ├── config/          # Configuration loading
│   ├── db/              # Database models and operations
│   ├── modules/         # Bot command handlers
│   ├── utils/           # Utility functions (incl. httpserver for health/metrics/webhook)
│   ├── i18n/            # Internationalization
├── migrations/          # SQL migration files
├── locales/             # Translation files
└── docs/                # Documentation

Development Mode

For development, run with debug logging:

DEBUG=true make run

Or set in your .env file:

DEBUG=true

GoReleaser Configuration

The .goreleaser.yaml defines the build process:

version: 2
project_name: alita_robot

builds:
  - binary: alita_robot
    env:
      - CGO_ENABLED=0
    goos:
      - darwin
      - linux
      - windows
    goarch:
      - amd64
      - arm64
    flags:
      - -trimpath
    ldflags:
      - -s -w
    mod_timestamp: "{{ .CommitTimestamp }}"

Build Output

After running make build, binaries are created in:

dist/
├── alita_robot_darwin_amd64_v1/alita_robot
├── alita_robot_darwin_arm64_v8.0/alita_robot
├── alita_robot_linux_amd64_v1/alita_robot
├── alita_robot_linux_arm64_v8.0/alita_robot
├── alita_robot_windows_amd64_v1/alita_robot.exe
├── alita_robot_windows_arm64_v8.0/alita_robot.exe
├── alita_robot_<version>_{macOS,linux}_{amd64,arm64}.tar.gz
├── alita_robot_<version>_windows_{amd64,arm64}.zip
└── checksums.txt

Dependencies

Key dependencies from go.mod:

Testing

# Run linter (recommended before commits)
make lint

# Run test suite
make test

# Test manually with a test bot
DEBUG=true make run

Hot Reload (Development)

# Install air
go install github.com/air-verse/air@latest

# Create .air.toml
air init

# Run with hot reload
air

Example .air.toml:

root = "."
tmp_dir = "tmp"

[build]
cmd = "go build -o ./tmp/alita_robot ."
bin = "tmp/alita_robot"
include_ext = ["go"]
exclude_dir = ["tmp", "vendor", "docs"]

Contributing

1. Fork the repository
2. Create a feature branch
3. Make changes
4. Run make lint and fix any issues
5. Submit a pull request

See Contributing Guide for more details.

Troubleshooting

Go version too old

go: go.mod requires go >= 1.26

Update Go to version 1.26 or higher.

golangci-lint not found

# Install golangci-lint
go install github.com/golangci/golangci-lint/v2/cmd/golangci-lint@v2.14.0

# Add to PATH
export PATH=$PATH:$(go env GOPATH)/bin

Linter cannot read Go export data

If linting reports export data version 5 is greater than maximum supported version 4 with Go 1.27.2, upgrade golangci-lint to v2.14.0 or newer. Keep both CI lint steps and the pre-commit hook on the same version. This is a linter compatibility error, not a broken standard-library import.

Module download errors

# Clear module cache
go clean -modcache

# Download dependencies
make tidy

Build fails with CGO errors

CGO_ENABLED=1 go build -o alita_robot .