Installation and Setup
Prerequisites
Algolang requires:
- Go version 1.25 or later (https://go.dev/dl/)
- Make (included on macOS and most Linux distributions)
- A code editor or IDE (Visual Studio Code with the Go extension, GoLand, or any editor of your choice)
Building from source
Clone the repository and build the algo executable:
git clone <repository-url>
cd algolang
make allThe make all target performs three steps:
make clean– removes any existing binarymake generate– scans thestrategies/directory and generatescmd/builtin_strategies_gen.go, which registers all built-in strategiesmake algo– compiles thealgobinary
After building, the algo binary is in the current directory. You can move it to a location on your PATH for convenience.
If you only need to rebuild after modifying a strategy:
make generate && make algoDirectory structure
Algolang uses the following directories:
| Directory | Purpose |
|---|---|
~/.algolang/cache | Local cache for downloaded market data |
~/.algolang/configs | Default location for configuration files |
~/.algolang/portfolios | Portfolio symbol list files (e.g., metals, energy) |
These directories are created automatically on first use.
Verifying the installation
Run the following commands to verify that Algolang is working:
# Check the version
algo version
# List available strategies
algo strategies
# List available futures symbols
algo symbols -t futureIf all three commands produce output without errors, Algolang is installed and ready to use.