How to install and use GlimpseKit

From a new Mac to your first translation and your first app. Each step is a command to type in Terminal.

Before you install

You need a Mac with Apple Silicon (M1 or newer) and macOS 14 Sonoma or newer, 16 GB of memory (32 GB for the coding agent), and 25 to 60 GB free on an SSD. Setup downloads 25 to 50 GB of models once; after that GlimpseKit works offline. You don't need Python, Docker, or an API key.

Install

  1. Install Apple's command line tools: xcode-select --install
  2. Install Homebrew, with the command on brew.sh
  3. Install Node.js: brew install node
  4. Install LM Studio, open it once, then quit it: brew install --cask lm-studio && open -a "LM Studio"
  5. Install GlimpseKit: npm install -g glimpsekit
  6. Set it up: gk setup:install (it asks a few questions, then installs tools, the speech engine and models for your Mac's memory)
  7. Start the model server: gk server:start (again after each restart)
  8. Check everything: gk setup:doctor (everything should show ✓)

Your first translation

echo "Hello, and welcome to the team." > hello.txt
gk language:translate hello.txt hello.fr.txt fr

The same command translates speech: gk language:translate interview.m4a interview.fr.txt fr. Subtitles come from a video's soundtrack: gk video:subtitle tour.mov tour.de.vtt de.

Build an app

  1. Load the coding model: gk server:start
  2. See the recipes: gk project:recipes
  3. Make an app from one: gk project:create tour spatial-worlds
  4. Build it phase by phase on your own model: gk claude:phases tour
  5. See it: gk app:dev tour

Each phase is planned, built, checked in a browser and committed. A local agent is slower than a cloud one: expect about a minute and a half for its first reply in a session.

Build a small website

The skeleton recipe makes a website in plain HTML and CSS, with no framework and no build step. Write what the site is in sources/brief.md, add PDFs, documents and pictures to sources/, and the agent builds the pages. This site was made that way.

gk project:create mysite skeleton
gk claude:phases mysite