Skip to content
OxyHQPublic

About

AI-powered search engine with cited sources

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Clarity

Oxy's search engine — the web, jobs, news and markets — with its assistant in Alia.

Architecture

Clarity client (Expo)
  -> Clarity API: search, Jobs, places, market, news, Experience,
     notifications, feedback, plans (PostgreSQL)
  -> Alia, through @gemies/sdk, under the person's own Oxy session:
     the Clarity agent's conversation, paid by the person's Alia credits
       -> Clarity's capability catalogue (/_oxy/mcp), under the person's ticket

Clarity's assistant is an ordinary public Alia agent owned by Clarity's project account and confined to Clarity by Oxy. The backend never calls Alia; Alia reaches Clarity through its capability catalogue. Clarity has no inference-provider adapters, keys or route selection: its one inference call is search embeddings on https://kaana.ai/v1, never a hostname under oxy.so.

Packages

Package Purpose
@clarity/frontend Expo app for web, iOS and Android
@clarity/backend Express product API and capability catalogue (MCP)
@clarity/shared-types Jobs, market and news DTOs
@clarity.surf/sdk Public SDK for Search, Jobs, Indexing and News

Local development

bun install
cp packages/backend/.env.example packages/backend/.env
bun run dev:backend
bun run dev:frontend

The API requires DATABASE_URL. It authenticates to Oxy as its attested ECS task role (oxy-clarity-task, oxy ADR 0026) and holds no Oxy key pair — the former backend credential is retired — so a local checkout cannot reach Oxy as Clarity. Redis, Stripe and browser-push settings are optional.

bun run lint            # Biome (lint + format check), whole repo — CI runs `bunx biome ci .`
bun run --filter @clarity/backend test
bun run build:backend

The default branch is main. Migration and cutover instructions are in docs/postgres-alia-migration.md; the branch does not claim any production cutover or deployment.

Documentation

About

AI-powered search engine with cited sources

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages