Tiny Agent

Tiny Agent is a small Go HTTP API that exposes health checks and host runtime metrics.

Endpoints

• GET /hello returns a greeting.
• GET /health returns a service health response.
• GET /info returns Go, OS, CPU, memory, and root filesystem usage data.

Run locally

go run .

The server listens on localhost:8888 by default. Configure the bind address and port with LISTEN_IP and LISTEN_PORT:

LISTEN_IP=0.0.0.0 LISTEN_PORT=9000 go run .

Example request:

curl http://localhost:8888/info

Build

go build -o tiny-agent .
./tiny-agent

Docker

docker build -t tiny-agent .
docker run --rm -p 8888:8888 tiny-agent

The image binds to 0.0.0.0:8888 and runs as a non-root user. A systemd unit is provided in tiny-agent.service for host installations.