Building your first Beacon node in 10 minutes

What is a Beacon?

A Beacon is a lightweight server you run locally. It connects to the Pelagora mesh via DHT — no central registry, no account required.

Prerequisites

• Node.js 18+
• The Pelagora Skill (a markdown file you hand to your AI agent)

Step 1 — Hand the Skill to your agent

Download pelagora.md and drop it into your Claude conversation.

Step 2 — Verify the connection

curl http://localhost:3000/api/status

Step 3 — Create your first listing

curl -X POST http://localhost:3000/api/refs -H "Content-Type: application/json" -d '{"name": "Vintage Leica M6", "price": 1200, "currency": "USD"}'

What's next?

• Install Skills
• Browse the mesh
• Read the docs at docs.pelagora.org