// Chapter 18 · Products
ParalleliX CODE
A terminal coding agent whose inference runs on the ParalleliX decentralized GPU network.
A coding agent backed by decentralized GPU.
// parallelix code · terminal repl · open-source models · sha-256 poe · $prlx credits
// What it does
Install once. Authenticate with a pk_live_ key. Run parallelix-code in your project. Type a task. The agent reads your files, writes changes, runs commands, and returns a Proof-of-Execution after each network call.
Every inference step calls api.parallelix.io/v1/chat/completions is the same OpenAI-compatible endpoint the rest of the ParalleliX AI surface uses. A network node serves the model on its local GPU, the coordinator verifies the result, and a SHA-256 hash commitment is returned with each response. The agent runs on open-source models: lower quality than frontier services, fully auditable execution path.
$ curl -fsSL https://parallelix.io/install-code.sh | sh
✓ parallelix-code installed
$ parallelix-code auth pk_live_…
✓ authenticated
$ parallelix-code
parallelix-code v1.0.0 · decentralized coding agent
> refactor auth middleware to use JWT
reading src/middleware/auth.ts...
⬡ node 12 sha256:a3f9c2… 0.0420 $PRLX
writing src/middleware/auth.ts...
Done.What it is and what it is not
// open-source models · lower quality than frontier · verifiable execution
A terminal coding agent
- Reads, writes, and runs code in your project directory
- Driven by open-source models on decentralized GPU nodes
- Every call returns a SHA-256 Proof-of-Execution
- Billed in $PRLX credits. Deposit once, no per-call gas
- OpenAI-compatible API at api.parallelix.io/v1
A frontier model service
- Does not match GPT-4 or Claude quality; open-source models only
- Not a browser extension or GUI
- Not a code completion plugin (it is a task-level REPL)
- Not backed by centralized cloud GPU; network nodes serve it
- Not free: each inference call costs $PRLX credits
Three steps to a running agent
// install · auth · repl · ready in under two minutes
// Quick start sequence
Install
curl -fsSL https://parallelix.io/install-code.sh | shPlaces parallelix-code on your PATH. macOS and Linux x86_64. Windows requires WSL2.
Authenticate
parallelix-code auth pk_live_<your-key>Get a pk_live_ key at ai.parallelix.io/developers. Written to ~/.parallelix-code/config.json.
Start the REPL
parallelix-codeOpens the interactive REPL. Type any coding task in plain language. /clear resets context. exit to quit.
How a task executes
// repl → api → node → poe → agent acts · 30-turn max per task
// Execution path · 5 stepsmax 30 turns
- // 01
REPL receives task
You type a task. The agent reads your project files to build context.
- // 02
API call to api.parallelix.io
The agent posts to api.parallelix.io/v1/chat/completions, an OpenAI-compatible endpoint routed to the network.
- // 03
Node serves inference
A network node runs the request on its local GPU through Ollama and returns a signed result.
- // 04
PoE printed
The coordinator verifies the result and returns the SHA-256 Proof-of-Execution. The REPL prints: node ID, hash, cost.
- // 05
Agent acts on the result
The model output is parsed for tool calls (read_file, write_file, bash, patch, etc.). The loop repeats up to 30 turns.
// Guide sections · 11 entries
- // 01
Overview
What ParalleliX CODE is, what it is not, and how it fits into the network.
- // 02
Install
The one-line installer and supported platforms.
- // 03
Authentication
Get a pk_live_ key and authenticate the agent.
- // 04
Starting a session
Open the REPL, set a working directory, choose a model.
- // 05
Example session
A realistic terminal transcript with PoE lines.
- // 06
Available tools
The nine tools the agent can invoke and what each does.
- // 07
REPL commands
/help, /add, /status, /git, /clear, /history, exit, quit.
- // 08
Proof-of-Execution
What the SHA-256 PoE line means: node, hash, cost.
- // 09
Credits
Deposit $PRLX once. No per-call gas. Custodial v1.
- // 10
Flags
--cwd, --model, --yes, --allow-outside-cwd.
- // 11
Config file
~/.parallelix-code/config.json fields and defaults.