> For the complete documentation index, see [llms.txt](https://orbitron.gitbook.io/orbitron-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://orbitron.gitbook.io/orbitron-docs/getting-started/quickstart.md).

# Quickstart

This section guides you through the **initial setup and usage** of Orbitron — your intelligent, terminal-based AI assistant.

### 1️⃣ Install Orbitron

Use the automated installation script for the fastest setup:

#### **macOS / Linux**

```bash
curl -fsSL https://orbitron.megaone.com/api/install.sh | bash
```

#### **Windows (PowerShell)**

```powershell
irm https://orbitron.megaone.com/api/install.ps1 | iex
```

After installation completes, restart your terminal and verify:

```bash
orbitron --help
```

👉 See [Installation](/orbitron-docs/user-guide/installation.md) for manual download options and detailed instructions.

***

### 2️⃣ Launch & Authenticate

Orbitron requires login to begin.

* First-time users will see a **login dialog** automatically.
* Alternatively, you can log in manually:

  ```bash
  /login
  ```

  or press `Ctrl + A`

Authentication Methods:

* **Browser-based login**
* **Manual token input** from [Orbitron Web](https://orbitron.megaone.com) → *Settings > Authentication Tokens*

👉 See [Authentication](/orbitron-docs/user-guide/authentication.md) for more details.

***

### 3️⃣ Select Your AI Model

You can choose your preferred model using:

* Command: `/model`
* Shortcut: `Ctrl + O`

If not specified, Orbitron automatically uses the highest-priority available model among the supported ones.

👉 See [Model Selection](/orbitron-docs/user-guide/supported-ai-models.md) for the full list.

***

### 4️⃣ (Optional) Load Context

To enable personalized responses and memory-based functionality, load a context:

* Commands: Use `/context`, `/context:tag`, or `/context:category`
* Shortcut: Press `Ctrl + K` to choose from existing contexts (stored in Orbitron Web)

👉 Learn more in [Orbitron Web](/orbitron-docs/user-guide/orbitron-web.md).

***

### 5️⃣ Start Using Orbitron

Once authentication and configuration are complete, you’re all set! 🎉

**🌐 Interactive Mode**

```bash
orbitron
```

**⚙️ Non-Interactive Mode**

```bash
orbitron -p "How do I create an S3 bucket?" -q -f json
```

👉 See [Orbitron Usage](/orbitron-docs/user-guide/usage.md).

***

### 🔒 Security & Data Management Notes

* All API keys and configuration are stored **locally** in `~/.orbitron`.
* Conversations are **not saved to any cloud by default**.
* Ideal for secure or air-gapped environments.

👉 See [Security & Privacy](/orbitron-docs/user-guide/security-and-privacy.md) for full details.

***

💡 You can open the command palette with `/` or use in-app shortcuts to perform additional actions!

***