Skip to content

Set up dev environment + add AGENTS.md - #1

Merged
donvito merged 1 commit into
mainfrom
melvin/dev-environment-setup-1a1c
Aug 3, 2026
Merged

Set up dev environment + add AGENTS.md#1
donvito merged 1 commit into
mainfrom
melvin/dev-environment-setup-1a1c

Conversation

@donvito

@donvito donvito commented Aug 3, 2026

Copy link
Copy Markdown
Owner

Summary

Sets up a full development environment for gaia-setup-personal (Go CLI + local web wizard that provisions Hermes Agent Docker containers) and documents it for future agents.

The only repository change is a new AGENTS.md. All environment tooling (Docker install, daemon config, runtime workaround) lives in the VM image / update script, not the repo.

What was set up

  • Go toolchain (go 1.22) — build, go vet, and go test ./... all pass.
  • Docker (docker-in-docker: fuse-overlayfs storage driver, containerd-snapshotter=false, iptables-legacy) so provision/start/list and the wizard work.
  • cgroup v2 workaround: this VM's cgroup namespace root is domain threaded, so the memory controller can't be applied to container cgroups and the app's hard-coded docker run --memory 2g failed. Added a nomem default runtime (/usr/local/bin/runc-nomem, registered in /etc/docker/daemon.json) that strips the memory limit from each OCI spec before calling real runc. No app code changed.
  • Update script: go mod download (minimal dependency refresh).

Verified end to end

Step Command Result
Build go build -o bin/gaia-setup-personal ./cmd/gaia-setup-personal OK
Lint go vet ./... OK
Test go test ./... internal/config passes
Doctor ./bin/gaia-setup-personal doctor docker: OK (server 29.7.1)
Hello world ./bin/gaia-setup-personal provision --id work --name "Work Assistant" --openrouter-key … --dashboard-pass … Started Hermes container gaia-personal-work
Wizard ./bin/gaia-setup-personal wizard /api/health, /api/instances, /api/doctor, dashboard UI all respond

The provisioned assistant container runs the Hermes gateway and serves a live dashboard (redirects to the "Sign in — Hermes Agent" page, HTTP 200) on 127.0.0.1:9121.

Demo

gaia_personal_end_to_end_demo.mp4

Shows the GAIA Personal management dashboard listing the running "Work Assistant", the setup wizard, and the provisioned Hermes Agent dashboard login page.

Open in Web Open in Cursor 

Co-authored-by: Melvin Vivas <melvindave@gmail.com>

@donvito donvito left a comment

Copy link
Copy Markdown
Owner Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

for cursor env

@donvito
donvito marked this pull request as ready for review August 3, 2026 14:35
@donvito
donvito merged commit 1bb7cd2 into main Aug 3, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants