Build Agent

How to get started in 3 minutes creating an Open Agent.

In this guide we will:

1. Clone the agent template

2. Generate and set API Key

3. Develop the agent with make-agent

4. Deploy your agent and go live!

1. Clone agent template

Bitte Next Agent Template

git clone https://github.com/BitteProtocol/agent-next-boilerplate.git

2. Get API Key and Set Environment Variables

• Get your api key at https://key.bitte.ai

• Change filename .env.example to .env and add your api key

BITTE_API_KEY="bitte_#####"

3. Start Coding

Install dependencies

cd agent-next-boilerplate && pnpm i

Run boilerplate, this will automatically run the make-agent library + your agent server

pnpm dev

When you run your project, the UI launches in your console, allowing you to access the chat sandbox with local dev environment connections for EVM and NEAR wallets. By testing the boilerplate with a command like "Hey, can you do a coinflip for me", you'll trigger the coinflip tool, which generates a random value.

You can customize tools by modifying their route's return value and updating the ai-plugin route manifest to define and provide LLM instructions for tool usage. You can learn more about your manifest here: Manifest

To send transactions, return the transaction body in your route. In the manifest, specify that the route returns a valid transaction. The runtime will automatically detect this if you have the appropriate tools (generate-evm-tx or generate-transaction) defined, which are already set up in the boilerplate and prepare the transaction in the UI. Check the create-near-transaction and create-evm-transaction routes for examples

4. Go live!

Consider pushing your code to its own GitHub repository and hosting it in a easy to deploy service like Vercel. There are other alternatives, but we find Vercel very easy to work with.

Note that your deploy script includes make-agent deploy. This command will validate your API key, look into the deployment URL (for most common hosting providers) and automatically communicate any changes made to our registry.

In case you want to have more control over your deployment URL, you can set BITTE_AGENT_URL

BITTE_AGENT_URL=<YOUR_DESIRED_URL>

---

From your own repo

Install make-agent

make-agent is a CLI tool that was built to make the development of an Open Agent as easy as possible-

The templates should have these packages installed. But if you're trying to add this to an existing project, please install make-agent and concurrently.

npm

npm i -D make-agent concurrently

pnpm

bun

Your package.json should look like this:

  "scripts": {
    "dev": "concurrently \"next dev\" \"make-agent dev --port 3000\"",
    "build": "next build && make-agent deploy",
    "start": "next start",
    "lint": "next lint"
  },

You can now run in development mode.

npm

npm run dev

pnpm

bun

Learn more about the Manifest file by following the link below.

Manifest