ccLoad

(★ 392)

AI API gateway that ends manual channel switching with smart routing, auto failover, exponential cooldown, multi-URL scheduling, live request monitoring and soft-error detection.

  • .dockerignore
  • .env.docker.example
  • .env.example
  • .gitignore
  • .golangci.yml
  • buf.gen.yaml
  • buf.yaml
  • CLAUDE.md
  • codegraph.json
  • com.ccload.service.plist.template
  • docker-compose.build.yml
  • docker-compose.yml
  • Dockerfile
  • embed.go
  • go.mod
  • go.sum
  • LICENSE
  • main.go
  • Makefile
  • README.md
  • README.zh-CN.md

🚀 Installation Guide

1. Get the code
git clone https://github.com/caidaoli/ccLoad

Downloads the entire project code from GitHub to your computer.

cd ccLoad

Moves into the project folder you just downloaded.

2. Docker

Easy Recommended
Prerequisites
  • Git Needed to download the project code from GitHub.
  • Docker Desktop Needed to build and run containers. Install it and keep it running in the background.
curl -o docker-compose.yml https://raw.githubusercontent.com/caidaoli/ccLoad/master/docker-compose.yml

Runs the command against the services defined in the compose file.

curl -o .env https://raw.githubusercontent.com/caidaoli/ccLoad/master/.env.docker.example

Type this command into your terminal and run it.

docker-compose up -d

Runs the command against the services defined in the compose file.

docker pull ghcr.io/caidaoli/ccload:latest

Type this command into your terminal and run it.

docker run -d --name ccload \

Runs the built image as an actual container.

Run docker compose ps to check the containers are Up. If the README mentions a port, open http://localhost:PORT in your browser.

Pulled directly from this repo's README.

3. Go

Medium
Prerequisites
  • Git Needed to download the project code from GitHub.
  • Go The Go compiler and toolchain.
go build -tags sonic -o ccload .

Compiles the Go program into an executable.

go run -tags sonic .

Runs the Go program directly without a separate build step.

If the build finishes without errors, it worked. If you used go run ., check the terminal output.

Pulled directly from this repo's README.

4. Make

Medium
Prerequisites
  • Git Needed to download the project code from GitHub.
  • Make Usually pre-installed on Linux/macOS. On Windows, install separately (e.g. via MSYS2 or WSL).
make build

Compiles the code based on the generated build configuration to produce an executable.

make dev

Compiles the code based on the generated build configuration to produce an executable.

make race-fast # high-value race subset

Compiles the code based on the generated build configuration to produce an executable.

make race # full race suite

Compiles the code based on the generated build configuration to produce an executable.

make verify-web # frontend node:test checks

Compiles the code based on the generated build configuration to produce an executable.

If it finishes without errors, it worked. Try running the generated executable directly.

Pulled directly from this repo's README.

// repository documentation