ATProto-based AI Assistant Chat interface.

Merge web-rebuild: the web app on TanStack Start. Port main's no-models composer block, role and model summary pages, API keys and Cron pages into its feature folders

hadsie.com · 3w ago

Merge pull request #6 from

hadsie.com · 3w ago

Add API key interface and a cron route. Improve the role membership hooks.

hadsie.com · 3w ago

Have components return early rather than return a ternary when what they render depends on a condition. The loading guards in the preferences, plugin settings, admin settings, and access pages show their error or nothing with two plain returns, ReplyStream, Text, Status, and the Markdown image renderer return early, and ConversationView picks each message's actions in an actionsFor helper in place of a nested ternary. CLAUDE.md states the

pouriade.com · 3w ago

Share the sidebar page shell between the admin and settings layouts, and group the secret props on SchemaFields. SidebarLayout in src/shared renders the sidebar beside the current section, taking the sidebar's contents as its nav, so AdminLayout and SettingsLayout hold only their own links. SchemaFields takes one optional secrets prop in place of secretFields, secretsSet, cleared, and onClear, with the cleared list and its handler together under clearing, so a form cannot offer clearing without

pouriade.com · 3w ago

Cover the web UI spec's acceptance criteria with tests and tick them off. New tests cover the server redirecting signed-out users before rendering, a viewer being sent from the settings to the login page while a shared chat still opens for them, creating a chat, uploading a PDF and sending it as an attachment part, scrolling to the bottom on send, syncing in a message written from another client, deleting an API key, and the background sync switch. The tool details test now checks that each summary is

pouriade.com · 3w ago

Have React components take props: Props, declared as an interface, and read props.example rather than destructuring props in the signature. A component destructures only the values it builds other variables from, such as ModelSelect and EffortSelect passing the rest of their props to the select. Inline prop types became named interfaces, and CLAUDE.md states the

pouriade.com · 3w ago

Show a user's last active time in the admin users table only in the browser. The page renders on the server, where toLocaleString used the server's locale and time zone, so hydration never matched on a server in another zone and React rendered the page

pouriade.com · 3w ago

Group the web app's code by feature. Each folder in src/features (auth, chat-list, conversation, sharing, models, settings, admin) holds that feature's pages, layouts included, components, hooks, lib, and queries, and the routes stay thin, rendering a feature's page. Page files are named after the component they export. The query factories split from src/queries.ts into each feature's queries.ts, leaving staleTime in src/shared, which also holds the API client, errors, search params, and the schema forms that admin and settings share. inheritedModel moves from the models module to the conversation's branch module, so models no longer depends on the conversation. Tests mirror the new tree, and the specs, the architecture doc, and CLAUDE.md name the new

pouriade.com · 3w ago

Keep web app state in one place rather than in copies that go stale. The API keys page and the admin provider models read the listed models from their mutation, and the API keys page clears them when the provider, key, or base URL changes, so a key is no longer saved with models listed for another provider. The composer and regenerate hold the chosen model by reference, with ModelSelect handing back a ModelRef, and the composer takes no images for a chosen model no longer on offer. The users search box follows the URL's q, so the sidebar link empties it, while keeping focus after a search. Adding a plugin starts its fields over when the package changes, as its options already

pouriade.com · 3w ago

main · 2d ago Default

admin-config-export · 1w ago

rate-limits · 1w ago

spaces-alpha-20261001 · 3w ago

merge-web-rebuild · 3w ago

2d ago Latest

2d ago

2d ago

2d ago

2d ago

TypeScript 99%
CSS <1%
Docker <1%

README.md

Shared Computer Network AI Assistant Chat #

SCN Chat is an ATProto AI assistant chat interface allowing users to use their spaces capable PDS to host their chat history.

Status: early development. atproto spaces are in alpha, so expect breaking changes and do not store anything sensitive.

How it works #

Every chat is its own space. Each conversation lives in a permissioned space on the user's PDS.
Sharing uses the space's read policy. A chat can be shared read-only with specific people, or made public to anyone with an atproto account.
Your PDS is the API. Any client can hold a conversation by writing records directly to the PDS. See lexicons/README.md for the conventions.
Bring your own keys. Users can add API keys for any provider, admins can configure models for everyone. Any OpenAI-compatible endpoint is supported.
No spaces yet? Due to the alpha nature of permissioned spaces, the first phase of this app supports storing chats in the app's own database. Users still need an atproto account to sign in.

Features #

Phase 1:

One-on-one chat with streaming replies
Read-only sharing
Image attachments for vision models
PDF text extraction
Automatic chat titles
Chat history search
Web search and page fetch plugins
User and admin model configuration

TODO #

Image generation, as a plugin
PDF OCR
Speech to text and text to speech
Encrypted conversations. See specs/encrypted-conversations.md
Memories
MCP servers as tools
Browser and push notifications, and an installable PWA
Move plugin settings and tool switches to the user's PDS, through a generic plugin settings lexicon
Migrate chats between local storage and spaces, in both directions
Provider-native tools, such as built-in web search, for the models that support them
Web search for models without tool calling, by generating queries before the reply
Web fetch through external services such as Firecrawl or Tavily extract, for pages that need JavaScript
YouTube transcripts in web fetch

Getting started #

Requirements: #

Node 22.18 or newer (Node 24 is recommended)
pnpm 10
An ATProto account to sign in with.
A spaces enabled PDS (currently optional)

Setup #

Install dependencies: pnpm install
cp .env.example .env.
Run pnpm keys to generate secret keys. Copy OAUTH_PRIVATE_KEYS and SECRET_KEY into your .env.
Put your DID in ADMIN_DIDS so you can login and configure the application.

Start the app #

Run pnpm dev
Open http://127.0.0.1:3000 and sign in with your ATProto handle.
Open Settings > Admin to add your plugins and models, and choose who else can sign in.

Deploying #

See docs/deployment.md.

Extending #

Model providers, tools, file ingesters, and turn hooks are all plugins, so anyone can build their own integration. See:

License #