Skip to content
VibeKit is in alpha. The packages are unstable and not ready to build on — APIs will break without notice.

Your first project

This tutorial creates a contracts project, configures an agent, and starts a local Algorand network. You need Docker for LocalNet and a working vibekit command. See installation when working from a source checkout.

Create the project

Section titled “Create the project”

Choose the contracts starter, which includes PuyaTs contracts, generated TypeScript clients, and tests.

Terminal window
vibekit new my-algorand-app --template contracts
cd my-algorand-app
npm install

vibekit new finishes by offering to configure the agents in the project. Let it do that: the selected skills, agent instructions, and VibeKit MCP entry are installed by the CLI rather than baked into the starter.

Start LocalNet

Section titled “Start LocalNet”
Terminal window
vibekit localnet start
npm run build

LocalNet runs Algod, Indexer, and KMD through Docker. It owns ports 4001, 8980, and 4002, so stop another local Algorand network first if it already uses those ports.

Open your agent

Section titled “Open your agent”

Open the project with the agent harness you chose during setup. It now has the VibeKit MCP server and the relevant Algorand skills available. Ask it to read the project instructions, inspect the contract, or make a small change and run the test suite.

For chain actions, the agent uses typed tools. It discovers the available networks and passes a sender and network explicitly for writes. It should never ask you for a mnemonic or paste one into a prompt.

What next?

Section titled “What next?”