Lumachor — Contextualize AI with Bulletproof Context

Built on the Chat SDK template for Next.js & the AI SDK.

Lumachor is a turnkey Context Engine that sits on top of best-in-class LLMs and injects high-quality, tagged contexts into every conversation.
Stop wrangling prompts—pick a use case or describe your need and get studio-quality outputs instantly.

What is Lumachor? · Features · Model Providers · Architecture · API & Data Model · Deploy · Run locally · Logo & Brand

Lumachor Overview

Elevator Pitch
Lumachor isn’t another chatbot—it’s the world’s first Context Engine. We curate, tag, and generate contexts you can drop into any LLM conversation (OpenAI, Anthropic, etc.). No prompt-engineering degree required.

Context is the moat. Models are commoditized; the right context unlocks their power.
Wrapper, not a model. We leverage leading APIs and focus on context quality.
End-user simplicity. Select a template or describe your need—Lumachor retrieves or generates the context automatically.

What you can do

Instant Context Generation: “I need a calculus tutor” → Lumachor returns a tailored, structured context.
Tagged Context Library: Prebuilt and discoverable with full-text search + tag filters.
Multi-Model Chat: Choose providers at runtime; Lumachor slides the context into every request.
Research-Driven Improvement: Our lab continuously ingests/benchmarks “state of the art” prompts and refines them for vertical excellence.

Features

All Chat SDK template features are preserved and extended. Thank you, Vercel team. 💚

Next.js App Router
- Advanced routing for seamless navigation and performance
- React Server Components and Server Actions for fast, data-driven UIs
Vercel AI SDK
- Unified API for text, tool calls, and structured outputs
- Hooks for building dynamic chat and generative interfaces
shadcn/ui
- Tailwind CSS + Radix UI primitives
Data Persistence
- Neon/Supabase Postgres for chat history and context storage
- Vercel Blob for file uploads
Auth.js
- Simple, secure authentication
Lumachor Extensions
- Context Builder (generate from free-text + tags)
- Context Library with search, tags, stars, public/private
- Chat panel with context injection, model switching, attachments
- Beautiful, responsive Sidebar + Library + Search experience
- Elaborate, on-brand error and 404 pages

Model Providers

This template ships with xAI’s grok-2-1212 (via AI SDK) by default. With the AI SDK you can switch LLMs in a few lines to OpenAI, Anthropic, Cohere, Fireworks, and more.

Architecture

Frontend: Next.js 14, TypeScript, Tailwind, shadcn/ui, lucide-react
State: SWR (or React Query) + useLocalStorage for drafts/offline
Auth: Auth.js
Storage: Neon/Supabase Postgres + Vercel Blob

High-level flow

User describes goal (“What should the AI know?”).
Context Retrieval/Generation
- If a tagged match exists → fetch it.
- Else → generate a new context (LLM), save with metadata (name, tags, description).
Chat
- Start a session; Lumachor injects the selected context into each request.
Continuous Improvement
- Capture ratings/feedback to refine contexts over time.

API & Data Model

Tables (Postgres)

CREATE TABLE contexts (
  id UUID PRIMARY KEY,
  name TEXT,
  content TEXT,            -- structured JSON or markdown
  tags TEXT[],             -- e.g. ['homework','cook','interview']
  description TEXT,
  created_by UUID,
  created_at TIMESTAMP DEFAULT now()
);

CREATE TABLE conversations (
  id UUID PRIMARY KEY,
  user_id UUID,
  context_id UUID,         -- nullable (auto-generate on first message if none)
  messages JSONB,          -- streaming-friendly shape
  created_at TIMESTAMP DEFAULT now()
);

Core Endpoints

POST /api/contexts/generate Input: { userPrompt: string, tags: string[], model?: string } Action: Calls LLM to assemble a structured context → saves row → returns context.
GET /api/contexts Query: ?mine=1&starred=1&tags=a,b&withMeta=1 Action: List/paginate + filter by ownership/tags.
PATCH /api/contexts/:id Toggle like/star, update metadata.
DELETE /api/contexts/:id Remove context.
POST /api/chat (or via route handlers with AI SDK) Accepts { messages, contextId?, model } and streams model output with injected context.

The Context Builder prompt enforces a consistent structure: Title, Description, Background & Goals, Tone & Style, Constraints & Scope, Example Prompts.

UI Highlights

Sidebar: Always on-screen; content gracefully insets and scrolls alongside it.
Library: Sticky header controls, filterable tag rail, grid/list switcher, inspector panel.
Search: Jumbo search bar, range filters (24h/7d/30d), list/grid, Enter to open top hit.
Input Control Pill: Live state (auto/ready/streaming/busy) with soft indigo accents.
Error & 404: On-brand, glassy, animated fallback pages.

Deploy Your Own

You can deploy your own version to Vercel with one click (inherits the original template setup):

Running locally

Use the environment variables defined in .env.example. Vercel Project Env Vars are recommended, but a local .env works too.

Do not commit your .env.

Install Vercel CLI: npm i -g vercel
Link project: vercel link
Pull env vars: vercel env pull

pnpm install
pnpm dev

Your app should be running on http://localhost:3000.

Roadmap (Selected)

✅ Context Builder (generate → tag → save → use)
✅ Library with stars, public/private, inspector
✅ Multi-model chat with context injection
⏭ Eval harness for automated context benchmarking
⏭ Analytics and context-quality scoring
⏭ Multimodal contexts (voice, image) & richer tools

Logo & Brand

We ship the Lumachor mark as inline SVG and as files under public/brand/.

Files

public/brand/lumachor-mark.svg (default)
public/brand/lumachor-mark-bw.svg (monochrome)
public/brand/lumachor-mark-solid.svg (non-transparent variant)

React usage

// components/LumachorMark.tsx
export function LumachorMark(props: React.SVGProps<SVGSVGElement>) {
  return (
    <svg viewBox="0 0 32 32" aria-hidden="true" {...props}>
      <rect
        x="2"
        y="2"
        width="28"
        height="28"
        rx="8"
        ry="8"
        fill="currentColor"
        opacity="0.12"
      />
      <path
        d="M8 18c0-4.418 3.582-8 8-8 2.8 0 5.26 1.46 6.67 3.66.2.3.06.7-.26.86l-2.22 1.1a.66.66 0 0 1-.84-.23A5.33 5.33 0 0 0 16 13.33c-2.95 0-5.33 2.38-5.33 5.34V22c0 .37-.3.67-.67.67H8.67A.67.67 0 0 1 8 22v-4Z"
        fill="currentColor"
        opacity="0.85"
      />
      <circle cx="22.5" cy="21" r="2.5" fill="#C7D2FE" opacity="0.75" />
    </svg>
  );
}

Default: soft indigo base, subtle background rect (opacity="0.12"), accent dot #C7D2FE (indigo-200) at opacity="0.75".
Monochrome: use lumachor-mark-bw.svg or set all fills to currentColor.
Solid (non-transparent): lumachor-mark-solid.svg uses an opaque background for places where translucency clashes.

Example in README top banner:

<p align="center">
  <img alt="Lumachor mark" src="public/brand/lumachor-mark.svg" width="84" />
</p>

Acknowledgements

This project proudly builds on the Chat SDK template by Vercel.

Template: vercel/ai-chatbot
AI SDK: sdk.vercel.ai
Next.js: nextjs.org
shadcn/ui: ui.shadcn.com

Thanks to the open-source prompt community for inspiration and research materials.

License

MIT for template code unless otherwise noted. See repository LICENSE.

Included logo files (add these to your repo)

public/brand/lumachor-mark.svg (default, soft accent)

<svg viewBox="0 0 32 32" xmlns="http://www.w3.org/2000/svg">
  <rect x="2" y="2" width="28" height="28" rx="8" ry="8" fill="currentColor" opacity="0.12"/>
  <path d="M8 18c0-4.418 3.582-8 8-8 2.8 0 5.26 1.46 6.67 3.66.2.3.06.7-.26.86l-2.22 1.1a.66.66 0 0 1-.84-.23A5.33 5.33 0 0 0 16 13.33c-2.95 0-5.33 2.38-5.33 5.34V22c0 .37-.3.67-.67.67H8.67A.67.67 0 0 1 8 22v-4Z" fill="currentColor" opacity="0.85"/>
  <circle cx="22.5" cy="21" r="2.5" fill="#C7D2FE" opacity="0.75"/>
</svg>

public/brand/lumachor-mark-bw.svg (monochrome)

<svg viewBox="0 0 32 32" xmlns="http://www.w3.org/2000/svg">
  <rect x="2" y="2" width="28" height="28" rx="8" ry="8" fill="currentColor" opacity="0.12"/>
  <path d="M8 18c0-4.418 3.582-8 8-8 2.8 0 5.26 1.46 6.67 3.66.2.3.06.7-.26.86l-2.22 1.1a.66.66 0 0 1-.84-.23A5.33 5.33 0 0 0 16 13.33c-2.95 0-5.33 2.38-5.33 5.34V22c0 .37-.3.67-.67.67H8.67A.67.67 0 0 1 8 22v-4Z" fill="currentColor" opacity="0.85"/>
  <circle cx="22.5" cy="21" r="2.5" fill="currentColor" opacity="0.65"/>
</svg>

public/brand/lumachor-mark-solid.svg (opaque background)

<svg viewBox="0 0 32 32" xmlns="http://www.w3.org/2000/svg">
  <rect x="2" y="2" width="28" height="28" rx="8" ry="8" fill="currentColor"/>
  <path d="M8 18c0-4.418 3.582-8 8-8 2.8 0 5.26 1.46 6.67 3.66.2.3.06.7-.26.86l-2.22 1.1a.66.66 0 0 1-.84-.23A5.33 5.33 0 0 0 16 13.33c-2.95 0-5.33 2.38-5.33 5.34V22c0 .37-.3.67-.67.67H8.67A.67.67 0 0 1 8 22v-4Z" fill="white" opacity="0.9"/>
  <circle cx="22.5" cy="21" r="2.5" fill="#C7D2FE" opacity="0.85"/>
</svg>

Name		Name	Last commit message	Last commit date
Latest commit History 31 Commits
.vscode		.vscode
app		app
artifacts		artifacts
components		components
hooks		hooks
lib		lib
public/images		public/images
tests		tests
.env.example		.env.example
.eslintrc.json		.eslintrc.json
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
biome.jsonc		biome.jsonc
components.json		components.json
drizzle.config.ts		drizzle.config.ts
instrumentation.ts		instrumentation.ts
middleware.ts		middleware.ts
next-env.d.ts		next-env.d.ts
next.config.ts		next.config.ts
package.json		package.json
playwright.config.ts		playwright.config.ts
pnpm-lock.yaml		pnpm-lock.yaml
postcss.config.mjs		postcss.config.mjs
tailwind.config.ts		tailwind.config.ts
tsconfig.json		tsconfig.json

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

Lumachor — Contextualize AI with Bulletproof Context

Lumachor Overview

What you can do

Features

Model Providers

Architecture

API & Data Model

Tables (Postgres)

Core Endpoints

UI Highlights

Deploy Your Own

Running locally

Roadmap (Selected)

Logo & Brand

Files

React usage

Acknowledgements

License

Included logo files (add these to your repo)

About

Uh oh!

Releases

Packages

Contributors 2

Uh oh!

Languages

License

Kevin-Liu-01/Lumachor

Folders and files

Latest commit

History

Repository files navigation

Lumachor — Contextualize AI with Bulletproof Context

Lumachor Overview

What you can do

Features

Model Providers

Architecture

API & Data Model

Tables (Postgres)

Core Endpoints

UI Highlights

Deploy Your Own

Running locally

Roadmap (Selected)

Logo & Brand

Files

React usage

Acknowledgements

License

Included logo files (add these to your repo)

About

Topics

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Contributors 2

Uh oh!

Languages

Packages