Stackline AI 0.0.1

Provider-neutral AI apps, without leaking keys to the browser.

Stackline AI gives you backend contracts, a safe HTTP handler, provider adapters, optional RAG/memory, and a drop-in AI Studio web component.

Open live demo GitHub llms.txt llms-full.txt

@stackline/ai @stackline/ai-server @stackline/ai-ui @stackline/ai-ollama @stackline/ai-memory-sqlite @stackline/ai-rag-postgres

Install

npm install @stackline/ai @stackline/ai-server @stackline/ai-ui

Add a provider adapter on the backend, for example @stackline/ai-ollama. Do not put API keys or database credentials in frontend code.

Basic Frontend

import "@stackline/ai-ui";

<stackline-ai-studio></stackline-ai-studio>

Backend Gateway

import { createStacklineAIServer } from "@stackline/ai/server";
import { createStacklineAIHttpHandler } from "@stackline/ai-server";
import { ollamaProvider } from "@stackline/ai-ollama";

const ai = createStacklineAIServer({
  provider: ollamaProvider({
    target: process.env.OLLAMA_TARGET || "http://127.0.0.1:11434",
    apiKey: process.env.OLLAMA_API_KEY,
    model: process.env.OLLAMA_MODEL || "auto",
  }),
  rag: false,
  memory: false,
});

export const handleAI = createStacklineAIHttpHandler({
  server: ai,
  basePath: "/api/ai",
});

What The Live Demo Uses

Local Provider

A tiny demo provider returns deterministic responses.

Local RAG

RAG contexts come from an in-memory public document array.

No Secrets

No Ollama key, no PostgreSQL, no SQLite memory, no private data.