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

# CLI

> Run and connect a JupyterLab server to Alph from anywhere

## Installation

```bash theme={null}
pip install alphai
```

## Authentication

```bash theme={null}
alphai login
```

This opens your browser for secure authentication. Alternatively, use a token from [runalph.ai/account/tokens](https://runalph.ai/account/tokens):

```bash theme={null}
alphai login --token YOUR_TOKEN
```

## Start JupyterLab

```bash theme={null}
alphai jupyter lab
```

This starts JupyterLab locally and connects it to Alph. You'll be prompted to select an organization and project.

## Common Options

```bash theme={null}
# Specify org and project
alphai jupyter lab --org my-org --project my-project

# Use a specific port for the notebook server
alphai jupyter lab --port 8889

# Expose a web app through Alph's tunnel
alphai jupyter lab --app-port 5000
```

## Quick Reference

```bash theme={null}
alphai login                  # Authenticate
alphai logout                 # Clear credentials
alphai status                 # Check auth status

alphai orgs                   # List organizations
alphai projects               # List projects
alphai nb                     # Manage notebooks

alphai jupyter lab            # Start JupyterLab
```
