Skip to content

Latest commit

 

History

History
40 lines (30 loc) · 1.61 KB

Specification.md

File metadata and controls

40 lines (30 loc) · 1.61 KB

Chatpott Specification

Chatpott is a responsive conversational AI assistant for people in Oberhausen. The interface is available in German and English.

Chat

  • Anonymous or password-authenticated users can start and revisit conversations when enabled by the site configuration.
  • Responses stream from the Vercel AI SDK through an OpenRouter model selected by an administrator.
  • Messages support Markdown, maps, information cards, and source links.
  • The agent can read and search the context library, find calendar events, retrieve waste schedules, and terminate unsafe conversations.

Context

  • Administrators can upload .md and .txt files, directories, and ZIP archives.
  • Uploading the same path replaces the existing file.
  • Files can be organized in folders, previewed read-only, and deleted.
  • /orte/ and /websites/ mirror an external knowledge base through the context sync API: its upload creates and replaces changed files and deletes files that vanished upstream.
  • Text chunks are indexed for keyword and semantic search. A missing embedding marks work that is still pending or should be retried.

Administration

Administrators can:

  • manage users with the anonymous, user, and admin roles;
  • configure registration and anonymous chat access;
  • select the AI model, prompt, reasoning settings, limits, and tools;
  • inspect aggregate message, user, tool, token, and latency statistics.

Technology

  • React 19, TypeScript, Vite, TanStack Router, and Tailwind CSS
  • Convex database, functions, subscriptions, and Convex Auth
  • Vercel AI SDK with OpenRouter
  • Biome and TypeScript for source checks