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

> ## Agent Instructions
> Company name is Akhara AI (never Rubric AI). Keep lowercase rubric/rubrics only when meaning grading criteria.
> Expert Review (docs path talent/) is enterprise BYO experts for audit and review: invite customer specialists; do not pitch Akhara recruiting or a public expert career portal. RLHF and domain writing are secondary work types.
> Prefer concrete API examples against public hosts: Environments eval API https://agi.akhara.ai, Control plane PDP https://api.akhara.dev, Evaluation https://app.akhara.ai / https://api.akhara.ai, Expert Review portal https://talent.akhara.ai.
> Do not invent a public hostname for private orchestrators or env API internals.
> Do not confuse control-plane latches with Environments confirmation latches.
> Environments SDK/API examples: curl against https://agi.akhara.ai. Evaluation SDK: from akhara import Akhara and AKHARA_API_KEY.
> Start with /llms.txt for the docs index and OpenAPI links; fetch individual pages as .md exports.

# Account Setup

> Complete guide to setting up your Akhara account, workspace, team, and security settings.

## Create Your Account

<Steps>
  <Step title="Sign Up">
    Go to [app.akhara.ai/signup](https://app.akhara.ai/signup) and create your account with email or SSO.
  </Step>

  <Step title="Verify Email">
    Check your inbox and click the verification link.
  </Step>

  <Step title="Complete Profile">
    Add your name, role, and organization details.
  </Step>
</Steps>

### SSO Options

Akhara supports enterprise SSO providers:

| Provider         | Setup                       |
| ---------------- | --------------------------- |
| Google Workspace | Automatic with Google email |
| Okta             | SAML configuration required |
| Azure AD         | SAML configuration required |
| OneLogin         | SAML configuration required |

<Info>
  Enterprise SSO configuration is available on the Team and Enterprise plans. Contact support for setup assistance.
</Info>

## Workspace Configuration

Your workspace is the top-level container for all projects, datasets, and team members.

### Create a Workspace

1. After signup, you'll be prompted to create your first workspace
2. Choose a workspace name (e.g., "Acme Health AI")
3. Select your plan tier
4. Add a billing method (required for paid plans)

### Workspace Settings

Navigate to **Settings → Workspace** to configure:

| Setting              | Description                                   |
| -------------------- | --------------------------------------------- |
| **Workspace Name**   | Display name for your organization            |
| **Workspace Slug**   | URL-friendly identifier (e.g., `acme-health`) |
| **Default Region**   | Data residency region (US, EU, or custom)     |
| **Retention Policy** | How long to keep logged data                  |

## API Key Management

API keys authenticate your applications with Akhara.

### Create an API Key

1. Go to **Settings → API Keys**
2. Click **Create API Key**
3. Choose a name (e.g., "Production Triage App")
4. Select scopes (permissions)
5. Copy and securely store the key

<Warning>
  API keys are shown only once. Store them securely in your secrets manager (AWS Secrets Manager, HashiCorp Vault, etc.).
</Warning>

### Key Types

| Type     | Prefix     | Use Case                |
| -------- | ---------- | ----------------------- |
| **Live** | `gr_live_` | Production environments |
| **Test** | `gr_test_` | Development and testing |

### Scopes

| Scope   | Permissions                      |
| ------- | -------------------------------- |
| `read`  | View projects, logs, evaluations |
| `write` | Create logs, run evaluations     |
| `admin` | Manage team, settings, billing   |

```python theme={null}
# Using specific scopes
from akhara import Akhara

# Read-only client for dashboards
reader = Akhara(api_key="gr_live_readonly_key")

# Full access for production
client = Akhara(api_key="gr_live_full_key")
```

### Rotate Keys

To rotate an API key:

1. Create a new key with the same scopes
2. Update your applications to use the new key
3. Delete the old key

## Team Management

### Invite Team Members

1. Go to **Settings → Team**
2. Click **Invite Member**
3. Enter their email address
4. Assign a role

### Roles

| Role         | Permissions                            |
| ------------ | -------------------------------------- |
| **Owner**    | Full access, billing, delete workspace |
| **Admin**    | Manage team, projects, settings        |
| **Member**   | Create projects, run evaluations       |
| **Reviewer** | Review tasks only (clinician role)     |
| **Viewer**   | Read-only access to dashboards         |

### Reviewer Credentials

For clinical reviewers, you can verify and store credentials:

1. Navigate to **Settings → Team → Reviewers**
2. Click **Add Reviewer**
3. Enter credential information:
   * License type (MD, DO, NP, RN, etc.)
   * License number
   * State/jurisdiction
   * Expiration date
4. Upload verification documentation

## Notification Settings

Configure how you receive alerts and updates.

### Notification Channels

| Channel       | Use Case                             |
| ------------- | ------------------------------------ |
| **Email**     | Daily digests, evaluation complete   |
| **Slack**     | Real-time alerts, review assignments |
| **Webhook**   | Custom integrations, CI/CD           |
| **PagerDuty** | Critical safety alerts               |

### Set Up Slack Integration

1. Go to **Settings → Integrations → Slack**
2. Click **Connect to Slack**
3. Select a channel for notifications
4. Configure alert types

```python theme={null}
# Slack notification example
client.projects.update(
    project="patient-triage",
    notifications={
        "slack": {
            "channel": "#ai-safety-alerts",
            "events": ["evaluation_complete", "safety_threshold_breach"]
        }
    }
)
```

### Alert Thresholds

Configure automatic alerts when metrics breach thresholds:

```python theme={null}
client.projects.update(
    project="patient-triage",
    alert_rules=[
        {
            "metric": "under_triage_rate",
            "threshold": 0.01,  # 1%
            "comparison": "greater_than",
            "severity": "critical",
            "channels": ["slack", "pagerduty"]
        },
        {
            "metric": "red_flag_recall",
            "threshold": 0.95,  # 95%
            "comparison": "less_than",
            "severity": "warning",
            "channels": ["slack"]
        }
    ]
)
```

## Security Settings

### Two-Factor Authentication (2FA)

Enable 2FA for your account:

1. Go to **Settings → Security**
2. Click **Enable 2FA**
3. Scan the QR code with your authenticator app
4. Enter the verification code
5. Save backup codes securely

<Warning>
  For HIPAA compliance, we recommend requiring 2FA for all team members. Admins can enforce this in **Settings → Security → Require 2FA**.
</Warning>

### Session Management

View and manage active sessions:

1. Go to **Settings → Security → Sessions**
2. View all active sessions with device/location info
3. Click **Revoke** to end suspicious sessions
4. Enable "Single session only" for stricter security

### Audit Log

Access your complete audit trail:

1. Go to **Settings → Security → Audit Log**
2. Filter by user, action type, or date range
3. Export logs for compliance documentation

## Data Residency

Choose where your data is stored:

| Region     | Location      | Designed for               |
| ---------- | ------------- | -------------------------- |
| **US**     | AWS us-east-1 | HIPAA, SOC 2 (in progress) |
| **EU**     | AWS eu-west-1 | GDPR, HIPAA (in progress)  |
| **Custom** | Your VPC      | Enterprise only            |

<Info>
  Data residency is set at the workspace level and cannot be changed after creation. Contact support if you need to migrate regions.
</Info>

## Next Steps

<CardGroup cols={2}>
  <Card title="Create Your First Evaluation" icon="check" href="/evaluation/docs/getting-started/first-evaluation">
    Run evaluators on your data
  </Card>

  <Card title="Set Up CI Quality Gates" icon="circle-check" href="/evaluation/docs/tutorials/ci-cd">
    Gate deployments on evaluation results
  </Card>
</CardGroup>