> ## Documentation Index
> Fetch the complete documentation index at: https://usefused.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Initialize a project

> Create an agent, connect your model, and try it locally.

[Install Harnest](/docs/harnest/get-started/install), then follow these three steps.

<Steps>
  <Step title="Create your agent">
    Choose a framework and a new or empty directory:

    <CodeGroup>
      ```bash ADK theme={null}
      harnest init support-agent --framework adk
      ```

      ```bash LangGraph theme={null}
      harnest init support-agent --framework langgraph
      ```
    </CodeGroup>

    ```bash theme={null}
    cd support-agent
    ```

    Edit `instructions.md` to describe what your agent should do.
  </Step>

  <Step title="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 →](/docs/harnest/build/models-and-libraries/configure-a-model)
  </Step>

  <Step title="Test and try it">
    ```bash theme={null}
    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.
  </Step>
</Steps>

## 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](/docs/harnest/build/agent-concepts) · [Add Agent Tools](/docs/harnest/build/agent-tools) · [Configure serving](/docs/harnest/get-started/serve)