Quick Start

Get a Pelagora node running in under 2 minutes.

Prerequisites

• Node.js 18 or later
• npm 9 or later

Install with the CLI installer

The fastest way to get started:

npx pelagora-cli-installer

The installer will:

1. Create a project directory
2. Install the pelagora package
3. Generate a starter configuration
4. Optionally install the MCP server for AI assistant integration

Or install manually

mkdir my-node && cd my-node
npm init -y
npm install pelagora

Create a start script:

// start.js
const { createApp } = require('pelagora')

const app = createApp({
  port: 3737,
  enableDht: true,
})

app.listen(3737, () => {
  console.log('Pelagora node running at http://localhost:3737')
})

node start.js

Verify it's working

Open http://localhost:3737 in your browser to see the web UI.

Or check the API:

curl http://localhost:3737/health

Connect an AI assistant

If you installed the MCP server, add this to your Claude Desktop config (claude_desktop_config.json):

{
  "mcpServers": {
    "pelagora": {
      "command": "npx",
      "args": ["@pelagora/mcp"]
    }
  }
}

Now you can manage your inventory and search the network through natural language.

Next steps

• Architecture → — How the pieces fit together
• Web UI Guide → — Using the built-in interface
• API Reference → — Full REST API documentation
• MCP Tools → — All available AI assistant commands