Genesis Agent API

Genesis Agent is local-first autonomous agent software released under the MIT License.

The API is documented from the actual FastAPI route definitions in the public repository.

API Surfaces

Service	Default Local URL	Purpose
Control/UI server	`http://127.0.0.1:8790`	UI, jobs, onboarding, settings, emotions, tasks, evolution lab
Tool server	`http://127.0.0.1:8787`	Filesystem, Python execution, web fetch, audio, camera proxy tools
Voice service	`http://127.0.0.1:7777`	Voice profile discovery and speech synthesis
Camera service	`http://127.0.0.1:7798`	Snapshot, stream, and periodic camera capture

Documentation

README

Human API Reference

Generated OpenAPI JSON Contracts

Architecture Notes

MIT License

Core Example

Submit a local job to Genesis Agent:

curl -sS http://127.0.0.1:8790/api/jobs \
  -H 'Content-Type: application/json' \
  -H "Authorization: Bearer $GENESIS_CONTROL_TOKEN" \
  -d '{"text":"Summarize current project state.","kind":"user_query"}'

Security Boundary

Genesis Agent APIs are local trusted interfaces. The tool server can read and write files, execute Python, fetch URLs, play audio, and proxy camera operations.

Default operation should bind services to 127.0.0.1, use bearer tokens, and avoid exposing local ports to untrusted networks.