Account Setup

Create Your Account

Go to app.akhara.ai/signup and create your account with email or SSO.

Verify Email

Check your inbox and click the verification link.

Complete Profile

Add your name, role, and organization details.

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

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

Workspace Configuration

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

Create a Workspace

After signup, you’ll be prompted to create your first workspace
Choose a workspace name (e.g., “Acme Health AI”)
Select your plan tier
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

Go to Settings → API Keys
Click Create API Key
Choose a name (e.g., “Production Triage App”)
Select scopes (permissions)
Copy and securely store the key

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

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

# 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:

Create a new key with the same scopes
Update your applications to use the new key
Delete the old key

Team Management

Invite Team Members

Go to Settings → Team
Click Invite Member
Enter their email address
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:

Navigate to Settings → Team → Reviewers
Click Add Reviewer
Enter credential information:
- License type (MD, DO, NP, RN, etc.)
- License number
- State/jurisdiction
- Expiration date
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

Go to Settings → Integrations → Slack
Click Connect to Slack
Select a channel for notifications
Configure alert types

# 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:

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:

Go to Settings → Security
Click Enable 2FA
Scan the QR code with your authenticator app
Enter the verification code
Save backup codes securely

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

Session Management

View and manage active sessions:

Go to Settings → Security → Sessions
View all active sessions with device/location info
Click Revoke to end suspicious sessions
Enable “Single session only” for stricter security

Audit Log

Access your complete audit trail:

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

Data Residency

Choose where your data is stored:

Region	Location	Compliance
US	AWS us-east-1	HIPAA, SOC 2
EU	AWS eu-west-1	GDPR, HIPAA
Custom	Your VPC	Enterprise only

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

Overview

Getting Started

Core Concepts

Onboarding Guides

Evaluation Framework

Tutorials

Integrations

Create Your Account

SSO Options

Workspace Configuration

Create a Workspace

Workspace Settings

API Key Management

Create an API Key

Key Types

Scopes

Rotate Keys

Team Management

Invite Team Members

Roles

Reviewer Credentials

Notification Settings

Notification Channels

Set Up Slack Integration

Alert Thresholds

Security Settings

Two-Factor Authentication (2FA)

Session Management

Audit Log

Data Residency

Next Steps

Create Your First Evaluation

Set Up CI Quality Gates

​Create Your Account

​SSO Options

​Workspace Configuration

​Create a Workspace

​Workspace Settings

​API Key Management

​Create an API Key

​Key Types

​Scopes

​Rotate Keys

​Team Management

​Invite Team Members

​Roles

​Reviewer Credentials

​Notification Settings

​Notification Channels

​Set Up Slack Integration

​Alert Thresholds

​Security Settings

​Two-Factor Authentication (2FA)

​Session Management

​Audit Log

​Data Residency

​Next Steps

Create Your First Evaluation

Set Up CI Quality Gates

Create Your Account

SSO Options

Workspace Configuration

Create a Workspace

Workspace Settings

API Key Management

Create an API Key

Key Types

Scopes

Rotate Keys

Team Management

Invite Team Members

Roles

Reviewer Credentials

Notification Settings

Notification Channels

Set Up Slack Integration

Alert Thresholds

Security Settings

Two-Factor Authentication (2FA)

Session Management

Audit Log

Data Residency

Next Steps