{
 "cells": [
  {
   "cell_type": "raw",
   "id": "0f1b8d1e",
   "metadata": {},
   "source": [
    "---\n",
    "summary: Configure Yera and set up your first profile\n",
    "title: Setup\n",
    "---"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "7d670d27",
   "metadata": {},
   "source": [
    "By the end of this step, Yera will be configured with your available\n",
    "providers and ready to run applications.\n",
    "\n",
    "## Running Setup\n",
    "\n",
    "```bash\n",
    "yera setup\n",
    "```\n",
    "\n",
    "You'll be asked for a profile name first. A profile packages your provider\n",
    "connections and model defaults into a named configuration. This is useful later if\n",
    "you want to switch between different setups, like a work profile with AWS and\n",
    "a personal one with OpenAI. Hit enter to accept `default` as the name, or\n",
    "type your own.\n",
    "\n",
    "## Detecting Providers\n",
    "\n",
    "Yera will scan your environment and configure connections to whatever it\n",
    "finds. It will not copy any credentials secrets, it will only store information on\n",
    "how to find them.\n",
    "\n",
    "If a provider can't be auto-detected, you may be asked whether you'd like\n",
    "to enter its config manually. It's fine to skip these with `n`. You can\n",
    "always configure additional providers later with `yera setup provider`.\n",
    "\n",
    "## Choosing Your Default Model\n",
    "\n",
    "Once providers are configured, Yera finds the available models for each and\n",
    "asks you to pick a default LLM. You'll navigate a tree:\n",
    "\n",
    "```\n",
    "├── 0: anthropic  (9 models)\n",
    "├── 1: aws        (54 models)\n",
    "├── 2: azure      (2 models)\n",
    "...\n",
    "```\n",
    "\n",
    "Select a provider, then a model family, then a specific model.\n",
    "\n",
    "## Finishing Up\n",
    "\n",
    "When complete, Yera will display a summary of your new profile."
   ]
  }
 ],
 "metadata": {
  "kernelspec": {
   "display_name": "Python 3",
   "language": "python",
   "name": "python3"
  },
  "language_info": {
   "name": "python"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 5
}