Skip to content

Deploy OpenCircle

Run OpenCircle locally — Korean edition

A translated walkthrough for installing OpenCircle Server on a single Mac and meeting a Familiar of your own.

A translated edition of this guide is being prepared. The English steps below are current.

This is the same first-server walkthrough as Your first OpenCircle, condensed here while the localized version is finished. It takes a Mac with Docker Desktop to a claimed Server and a first conversation with your Familiar.

Before you begin

You need a Mac that can run Docker Desktop, an internet connection, and one API key from Venice, OpenRouter, or OpenAI kept in a password manager.

Install and claim your Server

Install the signed CLI, add a local profile, then deploy with browser claim. Create your owner handle, permanent password, and a separate approval PIN, and save every recovery code before continuing.

Terminal

~/.local/bin/opencircle profile add my-server \
  --transport=local --lifecycle=compose --instance-id=my-server --yes
~/.local/bin/opencircle deploy \
  --profile my-server --owner-mode claim --finish guide

Meet your Familiar

Add a model key in Server admin, open your first conversation, and send a short message describing something you want to make. Customize your Familiar's name and personality afterward from Settings.

Keep going

Continue with the full local deployment guide, then read Upgrade safely and Back up and restore before you rely on this Server.