# Now I Open source another desktop agent Teralexi

> Source: <https://github.com/Naughty-Otters/Teralexi>
> Published: 2026-07-21 20:29:03+00:00

Last successful build |
2026-07-21T18:50:26Z |
Branch |
`main` |
Commit |
`4275d70` |

**Workflow run**[View logs](https://github.com/Naughty-Otters/Teralexi/actions/runs/29858065574)Local 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://www.teralexi.com/).

[https://github.com/Naughty-Otters/Teralexi/raw/main/media/howto_website_2.mp4](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
# edit BASE_API in env/.env (e.g. http://localhost:8000), then:
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](/Naughty-Otters/Teralexi/blob/main/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 includes`metrics.write`

. **Support upload** and**website 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 change`BASE_API`

/`build.json`

publish URL so they do not auto-update from Teralexi’s feed.

See [Privacy Policy](https://www.teralexi.com/privacy.html).

```
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.md](/Naughty-Otters/Teralexi/blob/main/SECURITY.md)[BUILD-AND-RELEASE.md](/Naughty-Otters/Teralexi/blob/main/BUILD-AND-RELEASE.md)[CODING.md](/Naughty-Otters/Teralexi/blob/main/CODING.md)[skills/SKILL-DEVELOPMENT.md](/Naughty-Otters/Teralexi/blob/main/skills/SKILL-DEVELOPMENT.md)[docs/](/Naughty-Otters/Teralexi/blob/main/docs)[CHANGELOG.md](/Naughty-Otters/Teralexi/blob/main/CHANGELOG.md)[NOTICE](/Naughty-Otters/Teralexi/blob/main/NOTICE)[teralexi.com](https://www.teralexi.com/)Teralexi is licensed under the [Apache License 2.0](/Naughty-Otters/Teralexi/blob/main/LICENSE). See [NOTICE](/Naughty-Otters/Teralexi/blob/main/NOTICE) for trademark and third-party notes.