gitwtfhub

wtf is polaris-local-first?

aevella/polaris-local-first — explained in plain English

Analysis updated 2026-05-18

164TypeScriptAudience · developerComplexity · 4/5LicenseSetup · moderate

TL;DR

Polaris is a local-first AI workspace where conversations, AI personas, tools, and saved materials persist on your own device across web, mobile, and desktop.

Mindmap

mindmap
  root((Polaris))
    What it does
      Local-first AI workspace
      Persistent conversations
      Tool call evidence
    Tech stack
      TypeScript
      Vite
      SQLite
      Cloudflare Workers
    Use cases
      Personal AI workspace
      Configurable personas
      Self-hosted backend
    Platforms
      Web
      iOS
      Android
      Desktop

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Build a personal AI workspace where chat history, saved files, and project context persist locally instead of living only in a remote server.

REASON 2

Create configurable AI personas with their own memory and tool permissions for different kinds of work.

REASON 3

Self-host your own backend so conversations and data never leave infrastructure you control.

REASON 4

Track every AI tool call as a visible, replayable event instead of a hidden side effect.

What's in the stack?

TypeScriptViteSQLiteIndexedDBCloudflare WorkersCapacitor

How it stacks up

aevella/polaris-local-firstmd0070/polymarket-trading-botnextweb4/yaml-proxy-editor
Stars164163165
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatehardhard
Complexity4/54/53/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Frontend runs standalone with npm run dev, but connecting a real backend requires setting an API origin environment variable.

AGPL-3.0 requires that if you modify and run this software as a network service, you must also release your modified source code.

Wtf does this do

Polaris is a local-first AI workspace built for people who work with AI models over long periods of time, not just single conversations. Instead of treating a chat as one disposable message stream, Polaris treats it as a persistent workspace where conversations survive restarts, collaborators keep a consistent identity and memory, useful results turn into saved cards or project materials, and every tool the AI uses leaves a visible record that later requests can reference. The project is organized around a few core ideas. There is a chat workspace with long-lived conversations, streaming replies, attachments, and import and export flows. There are configurable collaborators, essentially AI personas with their own settings, memory controls, and permissions for which tools they can use. There is a collection area for saved conversations, code snippets, images, files, and project materials that live outside the normal chat timeline. And there is a local-first data layer called LocalData that stores all of this on the user's own device rather than a remote server by default. Polaris runs across multiple platforms from one shared codebase: web, iOS, Android, and desktop, with native bridges only where a platform genuinely needs them. On native mobile it stores data in SQLite, while web and self-hosted browser builds use browser storage like IndexedDB. The project includes a Cloudflare Worker backend package for anyone who wants to connect their own backend or self-host. Getting started locally means installing dependencies and running the Vite development server, which starts the frontend only. Connecting a real backend requires setting an environment variable to point at a self-hosted or relay API origin, with more detailed setup notes provided in the project's documentation folder. The source code is licensed under AGPL-3.0-only, and the project welcomes contributions such as bug fixes, documentation improvements, and platform bridge work, while keeping overall product direction owner-led.

Yoink these prompts

Prompt 1
Help me set up Polaris locally with npm and connect it to my own self-hosted backend using VITE_POLARIS_API_ORIGIN.
Prompt 2
Explain how Polaris's LocalData layer stores conversations and cards differently on web versus native iOS and Android.
Prompt 3
Walk me through how to configure a new collaborator persona in Polaris with its own memory and tool permissions.
Prompt 4
What does Polaris's AGPL-3.0 license mean if I want to modify it and offer it as a hosted service?

Frequently asked questions

wtf is polaris-local-first?

Polaris is a local-first AI workspace where conversations, AI personas, tools, and saved materials persist on your own device across web, mobile, and desktop.

What language is polaris-local-first written in?

Mainly TypeScript. The stack also includes TypeScript, Vite, SQLite.

What license does polaris-local-first use?

AGPL-3.0 requires that if you modify and run this software as a network service, you must also release your modified source code.

How hard is polaris-local-first to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is polaris-local-first for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.