Last successful build |
2026-07-21T18:50:26Z |
Branch |
main |
Commit |
4275d70 |
Workflow runView logsLocal AI agent desktop — research, code, chat from your phone, extend with skills & MCP, pick any LLM, and build memory over time, all on your machine.
Prefer a ready-made installer? Get macOS and Windows builds from ** teralexi.com** — no build required.
This repository is for running and contributing from source.
Website agent walkthrough — pick an agent, plan, generate files, and preview the result. More product visuals: teralexi.com.
https://github.com/Naughty-Otters/Teralexi/raw/main/media/howto_website_2.mp4
-
Research with an agent that browses, gathers sources, and keeps you in the loop
-
Workspace & built-in IDE with inline git diff review before changes land
-
Channel chat (WhatsApp, Slack, Google, Discord, and more)
-
Skills & MCP hub, plus custom skills under
~/.teralexi/skills/ -
Local and cloud LLM providers (Ollama, OpenAI, Anthropic, Gemini, and more)
-
Local-first memory and scheduled agent jobs
Requirements: Node.js 22+ and npm
.
npm install
npm run dev
npm run dev
uses Electron hot reload. By default it loads env/.dev.env
, which sets BASE_API
to the public Teralexi platform (https://api.teralexi.com/
). That enables optional cloud features (sign-in, entitlements, usage metrics when signed in, support upload, website publish, auto-update checks).
You can use local LLMs without an account (Settings → LLM → Ollama / llama.cpp).
cp env/.dev.local.env.example env/.env
npm run dev
Or one-off:
BASE_API=http://localhost:8000 npm run dev
To explore the UI without a platform API, set BASE_API=
in your override env file. Cloud sign-in, metrics, support upload, website publish, and in-app updates will be unavailable.
Local load order for npm run dev
: env/.dev.env
→ env/.env
(wins) → env/.dev.local.env
(wins if present).
The platform API server is not included in this repository. Client contracts: docs/SUBSCRIPTION-INTEGRATION.md.
- Most agent data stays under
~/.teralexi/
on your machine (local-first). - When signed in to a platform API, the app may send
provider usage metrics(model/token counters) if your plan includesmetrics.write
. Support upload andwebsite publish only run when you trigger them and your entitlement allows it.- Packaged builds check
{BASE_API}/desktop/releases/stable/
for updates (no account required). Forks should changeBASE_API
/build.json
publish URL so they do not auto-update from Teralexi’s feed.
See Privacy Policy.
npm run dev # desktop app (public platform API by default)
npm run build # production desktop build
npm run build:web # renderer/main/preload build (CI validation)
npm run test:unit # unit tests
| Doc | Purpose |
|---|---|
SECURITY.mdBUILD-AND-RELEASE.mdCODING.mdskills/SKILL-DEVELOPMENT.mddocs/CHANGELOG.mdNOTICEteralexi.comTeralexi is licensed under the Apache License 2.0. See NOTICE for trademark and third-party notes.