← Back to UNICHANView on GitHub

Install UNICHAN

UNICHAN is an AI avatar that lives on your desktop, in Telegram, and in your browser (Chrome extension). She’s a helpful companion that can spot trades, analyze tokens, and act as a wallet with smart buy/sell management. Follow the steps below to install all three parts.

UNICHAN intro
UNICHAN on GitHub →

Clone the repo from the link above, then continue with the steps below.

What you need

  • Node.js (v20+) and pnpm
  • Python 3
  • Chrome (for the extension)

Step 1 — Clone and install

From a terminal (replace with your repo URL if different):

git clone https://github.com/dogtoshi-sz/unichan-mvp
cd UNICHAN-MVP
pnpm install
pnpm build:packages

Step 2 — Run the BRAIN

The BRAIN is the AI. Tamagotchi talks to it over HTTP. Leave this running in a terminal.

cd BRAIN
pip install -e .
unichan onboard    # First time only: set API key and workspace
unichan gateway    # Starts HTTP API on port 18790

First time you run unichan onboard, you’ll see the setup wizard to configure AI provider, personality, Telegram, gateway, workspace, and Birdeye:

UNICHAN setup wizard — unichan onboard
UNICHAN setup wizard (unichan onboard)

Step 3 — Run Tamagotchi (the avatar)

From the UNICHAN-MVP root (new terminal):

pnpm dev:tamagotchi

When the app opens:

  • Settings → Unichan — Set gateway to http://localhost:18790/v1/, then Test and Save.
  • Settings → Consciousness — Choose OpenClaw (Unichan brain).
  • Turn on the mic if you want voice.
Tamagotchi Settings — Consciousness (OpenClaw / Unichan brain)
Settings → Consciousness: OpenClaw (Unichan brain)

Step 4 — Add the Chrome extension

From the UNICHAN-MVP root:

pnpm build:extension

In Chrome:

  • Open chrome://extensions, turn on Developer mode.
  • Load unpacked → choose folder: CHROME-EXTENSION/.output/chrome-mv3 (inside your cloned repo; the folder name matches your repo name, e.g. UNICHAN-MVP).
  • In the extension popup: set WebSocket to ws://localhost:6121/ws, enable it, enable Page context, then Apply.

Step 5 — Use it

  • Desktop — Talk or type to UNICHAN in the Tamagotchi app; she’s your companion with voice and chat.
  • Browser — Browse in Chrome; she sees what you see and can spot trades, analyze tokens, and answer questions.
  • Telegram — (Optional) Connect the BRAIN to Telegram so UNICHAN can help you there too.
  • One avatar, one brain: token research, smart buy/sell ideas, and wallet-style management flow through the same UNICHAN.

If the extension shows Connection error, make sure Tamagotchi is running and the WebSocket URL is ws://localhost:6121/ws.

See it in action

UNICHAN on a token dashboard (GMGN), spotting trades and giving context-aware takes:

UNICHAN on GMGN — spotting trades
UNICHAN on GMGN: avatar sees the page and can warn about tokens

Desktop avatar (Tamagotchi):

Tamagotchi desktop — talk, type, she sees what you browse

Chrome extension sending context to the avatar:

Chrome extension — page context to UNICHAN

Connections at a glance

  • Extension → Tamagotchi: WebSocket on port 6121 (browser context).
  • Tamagotchi → BRAIN: HTTP on port 18790 (chat and tools).
UNICHAN on GitHub →