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

# Quickstart

> Install HumaLike and talk to your first AI NPC.

This guide takes a clean FiveM server from registration to its first AI NPC.

## 1. Register the server

Open the [AI NPC dashboard](https://humalike.ai/ai-npc), choose **Register
server**, and enter:

* A name that identifies the server in your dashboard.
* Its globally routable public IPv4 callback URL, for example
  `http://PUBLIC_IPV4:30120`.

Use the public IPv4 address players use to reach the FXServer. Hostnames, IPv6,
private addresses, loopback addresses, and reserved example addresses are not
accepted. The URL must use `http`, contain an explicit unprivileged port
(`1024`–`65535`), and have no path, query, or fragment.

The dashboard shows the new server license once. Copy it immediately. You can
rotate a lost or exposed license later.

## 2. Download the resource

Download `humalike.zip` from the latest
[GitHub release](https://github.com/Humalike/humalike-fivem-npc/releases/latest).
The archive contains a ready-to-run `humalike` directory.

Extract it into your server resources:

```text theme={null}
resources/
└── humalike/
    ├── fxmanifest.lua
    ├── integration/
    ├── npc/
    ├── voice/
    └── world/
```

## 3. Configure FXServer

Add the license immediately before the resource starts:

```cfg theme={null}
set humalike_license_key "ak_secret_replace_me"
ensure humalike
```

<Warning>
  Use `set`, not `setr`, for `humalike_license_key`. A replicated convar would
  expose the license to connected clients.
</Warning>

Do not configure voice URLs or voice secrets. HumaLike provisions voice
automatically from the server license.

## 4. Verify the connection

Start the server and run this in its console:

```text theme={null}
humalike_status
```

The resource should report installed runtime credentials and a selected player
provider. Framework and inventory providers appear when their dependencies are
running.

## 5. Create an NPC

In the dashboard:

1. Open the registered server.
2. Select **Create NPC**.
3. Start with a **Static** NPC.
4. Choose its name, personality, language, voice, model, and coordinates.
5. Save and enable it.

The NPC appears after the next roster refresh. You can also restart only the
`humalike` resource while setting up a new server.

## 6. Talk

Join the server, approach the NPC, hold your configured voice push-to-talk key,
and speak. HumaLike selects the NPC you are addressing from proximity, view
direction, following state, and vehicle context.

<Check>
  If the NPC appears, shows an active voice indicator, and answers, the core
  installation is complete.
</Check>

If any step fails, see [Operations and troubleshooting](/ai-npc/operations).

## Next

* [Configure HumaLike](/ai-npc/configuration) for your server.
* [Choose a framework integration](/ai-npc/frameworks).
* [Understand voice targeting](/ai-npc/voice).