Atrio is a small, self-hosted guest lounge for an AI persona that lets friends chat with your AI via one-time links while you only see a short AI-written summary, never the raw conversation.

Stars

32

7-day growth

No data

Forks

5

Open issues

0

License

CC-BY-4.0

Last updated

2026-07-11

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It implements privacy-by-design by design, ensuring the admin cannot read guest conversations and the guest-facing AI has zero tools, while offering extensible memory hooks and a pluggable LLM adapter.

Who it is for

  • Developers building self-hosted AI persona services
  • Privacy-conscious creators who want guest interactions without logs
  • Hobbyists experimenting with ephemeral AI conversations
  • Product owners prototyping guest-facing AI features

Use cases

  • Let friends chat with a custom AI persona via ephemeral links without exposing the conversation to the host
  • Provide a private, one-time AI interaction for feedback or interviews
  • Host an AI-powered guestbook that summarizes visits for the owner
  • Sandbox an AI persona for testing or showcase without risk of tool misuse

Strengths

  • Privacy-first: admin never sees raw transcripts; guest AI has no tools and memory is off by default
  • Self-contained backend module with clear API and hooks for memory, easily integrated into existing Express apps
  • Pluggable LLM adapter allows any model or API, not just Claude CLI
  • Well-documented with a minimal example and automated tests for core flow

Considerations

  • Ships without a real frontend; both admin UI and visitor page must be built by the user
  • Default LLM adapter requires the claude CLI installed and authenticated on the host
  • License is CC BY 4.0 requiring attribution if reused or modified

README quick start

Atrio

A small, self-hosted guest lounge for your AI persona — friends chat with your AI through one-time links, and you only ever see the AI-written visit summary. 一个小而干净、可自托管的 AI 人格「会客厅」——朋友凭一次性链接和你的 AI 聊天,你只看得到 AI 写的到访摘要。

Atrio is Italian/Spanish for "atrium, entrance hall" — the first room a guest steps into. (atrio 是意大利语/西语的「中庭、门厅」——客人进屋先到的地方。)

English · 中文


English

A small, self-hosted guest lounge for your AI persona.

Give a friend a one-time link. They open it and chat with your AI. When the visit ends, the AI writes you a short note about how it went — and that note is all you ever see. You never read the raw conversation.

It ships as a backend module (registerGuestRoutes(app, options)) plus a small runnable example host. There is no real UI — only a deliberately unstyled reference page to prove the wiring works. Bring your own front end.

Privacy by design

This is the whole point of the project, so it comes first.

  1. The admin side cannot read guest conversations. There is no "view log" endpoint. When a session ends, the persona writes a one-line summary; the management routes only ever return that summary plus non-content metadata (name, timestamps, message counts). The raw transcript never leaves the visitor's own token-scoped view.
  2. The guest-facing AI has zero tools. The default LLM adapter runs claude -p in an isolated temp directory with --strict-mcp-config (no MCP), --permission-mode default (no approver ⇒ any tool call is auto-denied), and every built-in tool explicitly disallowed. A guest cannot make the AI touch your filesystem, your network, or your MCP servers.
  3. Memory injection is OFF by default. The recall and memorize hooks are just seams. Out of the box, no memory is pulled in and nothing is written out. If you wire your own memory system in, you decide exactly what crosses the line.

Architecture

                 ┌─────────────────────────────────────────────┐
   admin  ─────▶ │  ADMIN routes (behind your adminAuth)        │
 (your UI)       │   POST /api/guest/create                     │
                 │   GET  /api/guest/list   ← summary only      │──▶  store.js
                 │   DELETE /api/guest/:id                      │   (atomic write +
                 └────────────────────────────────────

Description

A small self-hosted guest lounge for your AI persona — friends chat via one-time links; you only ever see the AI-written visit summary. CC BY 4.0.

Related repositories

Similar projects matched by category, topics, and programming language.

uzairansaruzi
Featured
uzairansaruzi GitHub avatar

hermex

Hermex is a native SwiftUI iPhone app that lets you control a self-hosted Hermes AI agent directly from your phone, with no subscriptions, tracking, or third-party relay.

AI & Machine LearningLarge Language Models
941
0xwilliamortiz
Featured
0xwilliamortiz GitHub avatar

openclaude-improved

OpenClaude is an open-source CLI coding agent that runs on any platform and supports a wide range of LLM providers, offering the same tools and workflows as Claude Code.

AI & Machine LearningLarge Language Models
577
deerwork-ai
Featured
deerwork-ai GitHub avatar

deer-workflow

An open-source Dynamic Workflow runtime that combines deterministic TypeScript orchestration with replaceable Agent runtimes.

AI & Machine LearningLarge Language Models
312