Skip to main content

Getting started

Pathvela is an open agentic framework. The same agent runs in your terminal through the CLI and inside your own app through the SDK, all backed by a single Pathvela account.

This section takes you from nothing to a running agent.

What's here

  • Introduction — what Pathvela is, and how the CLI and SDK fit together.
  • Installation — install the CLI, or add the SDK to your project.
  • Quickstart — get an agent answering in about two minutes.
  • Your Pathvela account — sign in, mint an API key, and understand metering.

The two-minute version

Run the agent in your terminal:

curl -fsSL https://agent.pathvela.com/install.sh | sh
lily

Or embed it in your app:

npm install @poolot/lily-web
import { createLilyAgent } from '@poolot/lily-web'

const agent = await createLilyAgent({ apiKey, model: 'poolot-standard' })
const answer = await agent.run([{ role: 'user', content: 'Hello, Pathvela!' }])

Both talk to the same Pathvela backend and are metered on your account. Learn the agent once, use it everywhere.