Getting started

Pick a package, install, run an example.

Getting started

Three steps to a running body.

1. Pick a package

# one body
npm install scp-protocol

# many bodies, one brain
npm install @srk0102/plexa

If you are not sure which to use, start with @srk0102/plexa. It includes everything in scp-protocol plus orchestration.

2. Get a brain (optional)

The bundled examples fall back to a stub brain that rotates through sensible actions, so you can run them without any LLM. To use a real brain locally:

# install ollama from https://ollama.ai
ollama pull llama3.2
ollama serve   # starts on http://localhost:11434

For hosted brains, set credentials:

• ANTHROPIC_API_KEY for AnthropicBrain.
• AWS credentials in the standard chain for BedrockBrain.

3. Run an example

git clone https://github.com/srk0102/plexa.git
cd plexa
npm install
node examples/inprocess-demo/index.js

Walkthrough version of the same example: Cart pole.

Where to go next

You want	Page
Understand the three layers	SCP: How it works
Write your own body	SCP: Adapter guide
Coordinate several bodies	Plexa: How it works
Add safety rules and approval	Plexa: Safety
Make memory survive restarts	Plexa: Memory
API surface	SCP API, Plexa API