Initialize a project

Install Harnest, then follow these three steps.

Create your agent

Choose a framework and a new or empty directory:

harnest init support-agent --framework adk

harnest init support-agent --framework langgraph

cd support-agent

Edit instructions.md to describe what your agent should do.

Connect your model

Replace these values under spec.environment in config.yaml:

Setting	Value
`OPENAI_MODEL`	Your model ID
`OPENAI_BASE_URL`	Your OpenAI-compatible API URL, including its prefix (usually `/v1`)

If your provider requires authentication, supply OPENAI_API_KEY through the runtime environment. Keep credentials out of config.yaml.Model configuration and examples →

Test and try it

harnest test .
harnest serve . --reload

Harnest prepares the environment automatically. Open http://127.0.0.1:1907/ to chat with your agent in the playground.

Choose a starting size

Append one of these flags to harnest init, or keep the default.

Option	What you get
Default	Agent files plus optional folder guides
`--minimal`	Only the files needed to compile and run
`--example`	Default scaffold plus inactive examples you can opt into

Explore the project structure · Add Agent Tools · Configure serving

Overview

Get started

Guides

Initialize a project

Choose a starting size

​Choose a starting size

Choose a starting size