> For the complete documentation index, see [llms.txt](https://docs.autonomi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.autonomi.com/developers/sdk/how-to-guides/start-the-local-daemon.md).

# Start the Local Daemon

Start a local daemon, a service that connects your applications to the Autonomi Network. Autonomi's daemon is called `antd`. Install it, keep it running in a terminal, and download a public image without setting up a wallet or making a payment.

## Steps

### 1. Install the daemon

Choose your operating system. These commands download the latest antd release into a new `antd` directory and check it against the release's published checksums before running it. They do not install a system service or change your `PATH`.

{% tabs %}
{% tab title="macOS" %}
Use Terminal on a Mac with Apple silicon. There is no prebuilt executable for Intel Macs.

```bash
BASE=https://gitlab.com/autonomi/ant-sdk/-/releases/permalink/latest/downloads
mkdir antd && cd antd &&
  curl --fail --location --show-error --remote-name "$BASE/antd-darwin-arm64" &&
  curl --fail --location --show-error --remote-name "$BASE/SHA256SUMS" &&
  grep 'antd-darwin-arm64$' SHA256SUMS | shasum -a 256 -c - &&
  mv antd-darwin-arm64 antd && chmod u+x antd && ./antd --version
```

{% endtab %}

{% tab title="Linux" %}
Run these commands in Bash with `curl` and `sha256sum` installed. The commands select the executable for your machine. The executables need glibc 2.38 or later, as on Ubuntu 24.04 or newer; check your version with `ldd --version`. On an older system there is no prebuilt antd; use the [CLI](https://docs.autonomi.com/developers/cli/use-the-cli.md) instead.

```bash
case "$(uname -m)" in
  x86_64) ASSET=antd-linux-amd64 ;;
  aarch64|arm64) ASSET=antd-linux-arm64 ;;
  *) ASSET=; printf 'No prebuilt executable for this architecture.\n' >&2 ;;
esac
BASE=https://gitlab.com/autonomi/ant-sdk/-/releases/permalink/latest/downloads
[ -n "$ASSET" ] && mkdir antd && cd antd &&
  curl --fail --location --show-error --remote-name "$BASE/$ASSET" &&
  curl --fail --location --show-error --remote-name "$BASE/SHA256SUMS" &&
  grep "$ASSET\$" SHA256SUMS | sha256sum -c - &&
  mv "$ASSET" antd && chmod u+x antd && ./antd --version
```

{% endtab %}

{% tab title="Windows" %}
Use PowerShell on Windows x64. The executable runs from the download directory, without an installer or administrator access.

```powershell
$ErrorActionPreference = 'Stop'
$Base = 'https://gitlab.com/autonomi/ant-sdk/-/releases/permalink/latest/downloads'
New-Item -ItemType Directory -Path antd | Out-Null
Set-Location antd
Invoke-WebRequest -UseBasicParsing -Uri "$Base/antd-windows-amd64.exe" -OutFile antd.exe
Invoke-WebRequest -UseBasicParsing -Uri "$Base/SHA256SUMS" -OutFile SHA256SUMS
$expected = ((Select-String -Path SHA256SUMS -Pattern 'antd-windows-amd64\.exe$').Line -split '\s+')[0]
$actual = (Get-FileHash -Algorithm SHA256 .\antd.exe).Hash
if ($actual -ne $expected) { throw 'Checksum mismatch. Do not run the downloaded file.' }
Write-Output 'antd.exe: OK'
.\antd.exe --version
if ($LASTEXITCODE -ne 0) { throw 'antd did not report its version successfully.' }
```

{% endtab %}
{% endtabs %}

Expect a line ending in `OK`, followed by `antd` and its version number. The checksum checks the file's contents; it is not a separate signature verification.

The remaining steps use the executable in this `antd` directory.

### 2. Start without a wallet

Run the executable from the same directory. Clear any wallet key left in your shell environment so this process starts without one:

{% tabs %}
{% tab title="macOS / Linux" %}

```bash
unset AUTONOMI_WALLET_KEY
./antd
```

{% endtab %}

{% tab title="Windows" %}

```powershell
$env:AUTONOMI_WALLET_KEY = $null
.\antd.exe
```

{% endtab %}
{% endtabs %}

Wait until the output includes `REST server listening on 127.0.0.1:8082`, then leave this terminal open while your application uses the service. Startup connects to network peers before the API becomes available. Without wallet configuration, you can retrieve data but cannot use wallet-backed uploads.

The APIs listen on your own computer by default. Keep that setting unless you add access controls: antd has no built-in authentication, and its API includes wallet and local-file operations.

### 3. Check the connection

Open another terminal and request the health endpoint:

{% tabs %}
{% tab title="macOS / Linux" %}

```bash
curl --fail --show-error http://localhost:8082/health
```

{% endtab %}

{% tab title="Windows" %}

```powershell
Invoke-RestMethod -Uri http://localhost:8082/health | ConvertTo-Json
```

{% endtab %}
{% endtabs %}

Look for this field in the JSON response:

```json
{
  "status": "ok",
  "version": "<antd version>"
}
```

`status: "ok"` means the local API is responding, and `version` shows the antd version you are running. The other fields describe network connectivity and payment configuration; see the [health reference](https://docs.autonomi.com/developers/sdk/reference/rest-api.md#health) when you need them.

### 4. Download your first file

Keep the first terminal running. In the second terminal, download this public image to `downloaded.jpg` in your current directory. Use a different output name if you already have a file with that name.

{% tabs %}
{% tab title="macOS / Linux" %}

```bash
curl --fail --show-error \
  'http://localhost:8082/v1/data/public/711c7e20006ff3e0ac6c1f3063286a0c1a3e4c409642e8c526173fa60bb7078a/stream' \
  --output downloaded.jpg
```

{% endtab %}

{% tab title="Windows" %}

```powershell
Invoke-WebRequest -UseBasicParsing `
  -Uri 'http://localhost:8082/v1/data/public/711c7e20006ff3e0ac6c1f3063286a0c1a3e4c409642e8c526173fa60bb7078a/stream' `
  -OutFile downloaded.jpg
```

{% endtab %}
{% endtabs %}

Open `downloaded.jpg` to see the image. It is a 138,931-byte JPEG. Your local service retrieved it from the Autonomi Network; no payment wallet was needed.

## What happened

You installed and started a local service, checked its API, and used it to retrieve a file. Applications can use the same service through a language client or its REST/gRPC API. Press Ctrl+C in the first terminal when you want to stop it.

## Next steps

* Use the service from [Python](https://docs.autonomi.com/developers/sdk/reference/language-bindings/python.md), [JavaScript](https://docs.autonomi.com/developers/sdk/reference/language-bindings/javascript.md), or [TypeScript](https://docs.autonomi.com/developers/sdk/reference/language-bindings/typescript.md).
* [Retrieve Data from the Network](https://docs.autonomi.com/developers/sdk/how-to-guides/retrieve-data-from-the-network.md) when you already have a file address
* [Store Data on the Network](https://docs.autonomi.com/developers/sdk/how-to-guides/store-data-on-the-network.md)
* [Prepare a Wallet for Uploads](https://docs.autonomi.com/developers/how-to-guides/prepare-a-wallet-for-uploads.md)
* [Use External Signers for Upload Payments](https://docs.autonomi.com/developers/sdk/how-to-guides/use-external-signers-for-upload-payments.md)
* [Set Up a Local Network](https://docs.autonomi.com/developers/how-to-guides/set-up-a-local-network.md)
* [SDK Overview](https://docs.autonomi.com/developers/sdk/reference/overview.md)
* [REST API](https://docs.autonomi.com/developers/sdk/reference/rest-api.md)
* [Use the CLI](https://docs.autonomi.com/developers/cli/use-the-cli.md)
