Aether Docs

A full-stack web application for uploading, browsing, searching, and chatting with your documents — built with Aether.

The Knowledge Base Manager is a complete, deployable application that showcases the Aether SDK beyond simple snippets. It demonstrates document management, semantic search, RAG-powered chat, and usage reporting — all through a clean REST API backed by Aether.

The same application is implemented in all four SDK languages. Each version exposes an identical API, so the concepts transfer directly regardless of your stack.

Python (FastAPI)

Async-native knowledge base with FastAPI and the Aether Python SDK.

TypeScript (Express)

Express server wired to the Aether TypeScript SDK.

Go (net/http)

Idiomatic Go server using only the standard library and the Aether Go SDK.

C# (ASP.NET)

Minimal API with ASP.NET Core and the Aether .NET SDK.

What it does

The Knowledge Base Manager lets users:

Upload documents — paste text or upload files into Aether
Browse and manage — list, view, delete, and restore documents
Search — run semantic queries across the entire document store
Chat — ask natural-language questions and get RAG-powered answers grounded in your documents
Track usage — check how many documents are stored

SDK operations used

Feature	Aether SDK methods
Upload document	`insert_text()`, `insert()`
List documents	`list()`
View document	`get()`, `download_text()`
Delete document	`delete()`
Restore document	`restore()`
Semantic search	`search()`
RAG chat	`retrieve()` + LLM call
Usage stats	`list()` pagination metadata

API contract

Every language implementation exposes the same REST endpoints:

text

GET    /api/documents              List all documents
POST   /api/documents              Insert a new document (text or file)
GET    /api/documents/:id          Get document metadata and content
DELETE /api/documents/:id          Soft-delete a document
POST   /api/documents/:id/restore  Restore a deleted document
GET    /api/search?q=...&k=...     Semantic search
POST   /api/chat                   RAG: retrieve context + generate answer
GET    /api/stats                  Usage stats (total document count)

All endpoints return JSON. The /api/chat endpoint uses Anthropic Claude for generation — if no ANTHROPIC_API_KEY is set, every other feature still works and the chat endpoint returns a helpful error message.

Environment variables

Configuration

AETHER_API_KEY — your Aether API key, passed to the client (required).
ANTHROPIC_API_KEY — Anthropic API key for the chat feature (optional).

Pick your language and follow the guide to get the app running.