Skip to main content

TIBET Home Agent — BYOK Mode 3 relay. Run on your laptop, paired to your `.aint`, your phone's app talks to it via I-Poll. Uses your local Claude Pro / Max / Gemini / ChatGPT session — no API key on the phone. v0.3 adds M110 — TIBET key-pinning on KILL/SHUTDOWN: the daemon refuses any kill-request not signed by the pinned Root_IDD Ed25519 key (Red Specter SWARM-005 remediation, RS-2026-001).

Project description

TIBET Home Agent

PyPI version License: MIT

BYOK Mode 3 — relay your existing Claude / Gemini / ChatGPT subscription to your phone.

Run this on your laptop. Pair it to your .aint sub-identity (e.g. home.vandemeent.aint). Your phone's K/IT app sends prompts via I-Poll to your home agent; the daemon dispatches to whatever upstream AI you have configured locally and sends the answer back over I-Poll.

No API key on your phone. Prompts never leave your hardware. The phone trusts only the .aint you signed in with.

Why this exists

Three BYOK modes for K/IT / AInternet:

  1. API key on phone — works today. You buy a Gemini / Anthropic / OpenAI key.
  2. Local model on LAN — run Ollama or Gemma 4 on a Mac with unified RAM.
  3. Home agent relay (this package) — reuse your existing desktop Claude / ChatGPT / Gemini Pro subscription. No new key, no new account.

Mode 3 is the cleanest for the millions of people who already pay for a desktop AI app and don't want to pay twice.

Quick start

pip install tibet-home-agent[gemini]   # or [anthropic] or [openai]

Set the environment variables:

export HOME_AGENT_AINT="home.vandemeent"            # your home-agent sub-domain
export HOME_AGENT_TOKEN="$(cat ~/.ainternet/.session.json | jq -r .token)"
export HOME_AGENT_PROVIDER="gemini"                  # or anthropic, openai, echo
export GEMINI_API_KEY="..."                          # the *daemon's* upstream key
export BRAIN_URL="https://brein.jaspervandemeent.nl"

Then run:

tibet-home-agent

You should see:

[home-agent] starting  aint=home.vandemeent.aint  brain=https://...  provider=gemini  poll=2s

On your phone (K/IT app): Settings → BYOK → provider = Home agent, home-agent address = home.vandemeent. Send a chat. Watch the daemon log show the dispatch + reply round-trip.

How it works

  1. Phone calls brain's /api/kit/ask with provider=home_agent, api_key=home.vandemeent (the home-agent address).
  2. Brain pushes an I-Poll TASK to home.vandemeent.aint carrying the prompt + thread id.
  3. This daemon polls inbox every 2 s, picks up the prompt, dispatches to the configured upstream (Gemini / Anthropic / OpenAI / echo), and pushes the answer back via I-Poll.
  4. Brain matches reply by thread id, returns answer to phone.

The phone never sees the upstream key. The daemon never sees the phone's user data beyond the prompt itself. Brain is a relay, not a data store.

Provider — echo

For first-run validation, set HOME_AGENT_PROVIDER=echo. The daemon echoes back the user's last message prefixed with [echo]. Round-trip should be < 5 s. Use this to confirm I-Poll plumbing works before connecting a real provider.

Roadmap

  • v0.1 (this release) — Gemini / Anthropic / OpenAI / echo provider. Daemon needs its own upstream API key.
  • v0.2 — MCP bridge: dispatch through a locally running Claude Desktop / ChatGPT app via MCP, so users with existing subscriptions don't need a separate API key.
  • v0.3 — local model dispatcher (Ollama, llama.cpp) so privacy users can stay fully on-device.
  • v0.4 — sealed-payload mode: prompts arrive encrypted, decrypted only on the user's device under user-side keys.

License

MIT.

Enterprise

For private hub hosting, SLA support, custom integrations, or compliance guidance:

Enterprise enterprise@humotica.com
Support support@humotica.com
Security security@humotica.com

Credits

Designed by Jasper van de Meent. Built by Jasper and Root AI as part of HumoticaOS.


Stack-positie: Groep agentic · Bootstrap = OSAPI-handshake naar tibet + jis (fail → snaft-rule + tibet-pol-rapport) · ← ainternet · See STACK.md · See demo/golden-path/ for the spine end-to-end.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

tibet_home_agent-0.5.1.tar.gz (23.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

tibet_home_agent-0.5.1-py3-none-any.whl (18.2 kB view details)

Uploaded Python 3

File details

Details for the file tibet_home_agent-0.5.1.tar.gz.

File metadata

  • Download URL: tibet_home_agent-0.5.1.tar.gz
  • Upload date:
  • Size: 23.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.5

File hashes

Hashes for tibet_home_agent-0.5.1.tar.gz
Algorithm Hash digest
SHA256 0d1d76d895e8f27eacc45d96b39063c486c2d3eff11ad0626b3354e88bc780f4
MD5 7e5815eda62d959eab8efb94045cfd35
BLAKE2b-256 2890b3c2f036976210f9042db15b5065c2fc8731591fe1ab2a2dcd619932761a

See more details on using hashes here.

File details

Details for the file tibet_home_agent-0.5.1-py3-none-any.whl.

File metadata

File hashes

Hashes for tibet_home_agent-0.5.1-py3-none-any.whl
Algorithm Hash digest
SHA256 bcb3f04bbdf33c8aa6f94836bbc3ad4f6d9dfdc29d9c46dc59362483d9f36b3b
MD5 dd57e17bdfa5ca1da31bb8eb93cb2592
BLAKE2b-256 0db9501acc8bea6e1ec58f71628a26daeff8d97c53551caf1007a8d7d4f39876

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page