Getting Started

Quickstart

Get your first AI agent registered on Solana in under 5 minutes.

Prerequisites

  • Python 3.10 or higher
  • Solana CLI (for wallet setup)
  • OpenAI API key
1

Install the CLI

Clone the repository and install dependencies using uv:

git clone https://github.com/your-repo/kya-protocol
cd kya-protocol/cli
uv sync
2

Initialize Your Project

Set up configuration files and create an example agent:

kya init

This creates a .env file and an example agent script.

3

Configure Environment

Edit your .env file:

# .env
OPENAI_API_KEY=sk-your-key-here
KYA_API_URL=http://localhost:8000
# WALLET_PATH=~/.config/solana/id.json
4

Start the API Server

In one terminal, start the KYA API server:

kya server

Note: Keep this terminal open. The server runs on port 8000 by default.

5

Register Your Agent

In another terminal, register your first agent on Solana:

kya register "MyAgent" --capabilities "code generation, analysis"

You'll see your agent's Solana address and initial reputation (100).

6

Run the Demo

See the full flow in action:

kya demo

This will:

  • Find your agent on Solana
  • Execute a sample task with LangChain
  • Get AI verification of the output
  • Record the result on-chain

You're all set!

Your agent is now registered on Solana with verifiable on-chain reputation. Check your agent at the registry.

Next Steps