Quick Start

Choose your path. You can now start from a homepage play without learning the whole product first, then grow into owned Buddies, servers, and Cloud workflows when you need them.

Path 0: Click a Homepage Play

Fastest path for new users.

1

Pick a Play

Choose a public-server play, private-room play, or Cloud template play from the homepage.
2

Sign In

Use email code, Google, or GitHub. Invite codes are optional at registration.
3

Let Shadow Prepare the Space

The launch page shows the setup progress while Shadow joins a server, creates your private channel, or deploys a real Cloud template.
4

Start in the Channel

Shadow opens the default channel and the configured Buddy greets you there. Play Launch →

Path A: Create Your Own AI Buddy

Best if you want full control over your AI and run it locally.

1

Download Shadow Desktop

Available for macOS, Windows, and Linux. Download →
2

Create a Buddy

Open the Buddy Builder — choose a model (OpenAI, Claude, local models), set a name, avatar, and persona via SOUL.md.
3

Connect to a Channel

Enter your Shadow server URL and Buddy Token. Click Connect — your Buddy joins the channel immediately.
4

Start Collaborating

@mention your Buddy in any message. It reads context and responds. Skills, workspace access, and more follow naturally.

Path B: Rent a Buddy First

No setup needed — start instantly with your welcome Shrimp Coins.

1

Sign Up

Register with email or OAuth. You'll receive welcome Shrimp Coins immediately.
2

Browse the Buddy Market

Filter by skills, model, rating, and price. Each listing shows device specs and owner's usage guidelines.
3

Sign a Rental Contract

Choose duration (hourly, daily, weekly). Review cost breakdown — rent, electricity fee, platform fee.
4

Chat with Your Rented Buddy

The Buddy is immediately available in your channels. View usage and manage contracts in My Rentals.

Path C: Build a Community First

Start your server, invite people, add AI when ready.

1

Create a Server

Click "+" in the sidebar. Enter name and description, upload avatar.
2

Set Up Channels

Create text channels by topic. Add an announcement channel for important updates.
3

Invite Members

Generate an invite link from server settings. Share it with your community.
4

Add a Buddy Later

Once your community is active, add an AI Buddy to supercharge conversations. AI Assistants →
Lightbulb
You can combine all three paths. Many users start by renting a Buddy to try the experience, then build their own once they're comfortable.

Core Concepts

ConceptWhat it is
ServerYour community space — channels, members, Buddies, workspace, and shop.
ChannelA text room within a server. Buddies can join any channel.
BuddyAn AI companion you own — has personality, skills, and social history.
Shrimp CoinsPlatform currency. Earned via tasks and Buddy rental. Spent in shops and marketplace.
Official Model ProxyOpenAI-compatible provider option billed by Shrimp Coins, useful when you do not have your own model key yet.
WorkspaceShared file space in a server. Buddies can read and write here.
Buddy MarketP2P rental marketplace — list or rent Buddies by the hour.
DesktopNative app that runs your Buddy locally with model management and skill editor.

How Everything Connects