====== Starting Out with a Muse AI Bot ======

This guide is for players who want a **Muse AI** to play Nilgiri for them — exploring, hunting, mapping, and reporting back — using the open-source [[https://github.com/nilgirian/Nilgiri-Muse-Bot|Nilgiri-Muse-Bot]] repository.

==== What it does ====

You hand the repository to your Muse (Meta's personal AI assistant). Your Muse logs into Nilgiri as one of your characters and plays it autonomously for a set time: it explores rooms, fights monsters for experience, maps new areas, banks treasure, and answers when spoken to in-game. When the session ends you get an adventure debrief — what happened, experience gained, kills, loot, and how it ended.

While the bot plays, you can watch from your own character and give it live orders — it responds within seconds.

==== What you need ====

  * A Muse account (the [[https://www.muse.ai|Muse app]] or web client).
  * An email address where your new character's temporary password can be sent (or an existing Nilgiri character — see below).
  * Nothing installed — your Muse does the setup itself.

==== Setting it up ====

Give your Muse the repository. In chat, point it at the GitHub URL:

> "Clone https://github.com/nilgirian/Nilgiri-Muse-Bot into your workspace and read it."

Your Muse will read the playbook and be ready.

Your Muse can **create a character for you** — no ready-made character needed:

> "Create a new Nilgiri character named //CharacterName// for me."

It runs the full creation flow (appearance randomized, temporary password emailed to an address you provide), and that password becomes the character's permanent one. (Character creation is rate-limited — see [[nilgiri:connect|Connecting to Nilgiri]] — so pick your name carefully.)

Already have a character? Just say so:

> "Log into Nilgiri as //CharacterName// for one hour and go hunting in the Hills and Plains."

Your Muse will ask for the character's password (used once, never stored), run the session, and report back.

==== Example prompts ====

  * "Log in as //MyChar// for 30 minutes and explore Newtonia."
  * "Take //MyChar// hunting — aggressive, consider everything."
  * "Map the area south of Midgaard and update the repo maps."

==== Watching and giving orders ====

Log in with your own character and watch. You can speak to the bot live — its owner's orders override its plans. Other players can talk to it, but it only takes orders from its authorized controllers.

==== Learn more ====

  * [[https://github.com/nilgirian/Nilgiri-Muse-Bot|Nilgiri-Muse-Bot on GitHub]] — the full kit: connection plumbing, maps, lessons, session stories.
  * [[nilgiri:newbie-strategy|Strategy for Newbies Guide]] — learn the game yourself, command by command.