File size: 1,574 Bytes
a42b94f 9315101 a42b94f c391285 34f80e0 c391285 a42b94f | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 | ---
license: apache-2.0
tags:
- snapkitty
- developer-tools
- c++
---
> Source: [github.com/SNAPKITTYWEST/hyperkitty-chromium](https://github.com/SNAPKITTYWEST/hyperkitty-chromium)
HyperKitty Chromium — Architecture
Status: implemented reference implementation. Every module, supervision relationship, schema, and API route described below exists in this repository and compiles, boots, and passes its test suite (rebar3 eunit: 24 tests, 0 failures, including real headless-Chromium integration tests and chaos tests that kill live processes to verify recovery). Sections are marked (planned) where the specification calls for something this revision intentionally stubs or defers — there is no unmarked aspirational content in this document.
1. Purpose and scope
HyperKitty Chromium is an Erlang/OTP-native browser agent platform: a headless Chromium instance, driven over the Chrome DevTools Protocol (CDP), wrapped in an explicit OTP supervision tree so that browser control, agent orchestration, search, and messaging are separate, independently-supervised, independently-observable subsystems rather than library calls inside one monolithic process. The design principle it exists to demonstrate: an LLM-driven "agent" is a planning function that proposes tool calls; it is never trusted with direct, unchecked access to a browser process. Every tool call crosses an explicit, typed capability boundary — enforced by Erlang code, not by the prompt — before it reaches Chromium.
---
## License
Licensed under **Apache-2.0**. Full text: [LICENSE](LICENSE).
|