Skip to main content

​
Creating Your Account

Alph uses authentication powered by Supabase, giving you multiple options for signing up and signing in.

​
Sign Up Methods

  • GitHub OAuth
  • Email & Password
Recommended for most users
  1. Click Sign in with GitHub on the login page
  2. Authorize Alph to access your GitHub account
  3. You’ll be automatically logged in
Benefits:
  • One-click authentication
  • Easier GitHub integration setup later
  • Automatic profile information
Both authentication methods provide the same access to Alph features. Choose whichever you’re most comfortable with.

​
Understanding Organizations

Organizations are the foundation of Alph’s workspace structure. Every user needs at least one organization to create notebooks and projects.

​
What is an Organization?

An organization is a workspace that contains:
  • Notebooks: Jupyter notebooks owned by the organization
  • Projects: Compute environments for running code
  • Members: Team members with different permission levels
  • Settings: Billing, integrations, and preferences
Think of organizations like GitHub organizations - a shared workspace for individuals or teams.

​
Creating Your First Organization

When you first sign in, you’ll be guided through creating an organization:
1

Choose a name

Pick a descriptive name for your organizationExamples:
  • Personal workspace: “Jane’s Workspace”
  • Research team: “ML Research Lab”
  • Company: “Acme Data Science”
2

Set your URL slug

This becomes part of your organization’s URL: runalph.ai/your-slugRequirements:
  • Lowercase letters and hyphens only
  • Must be unique across Alph
  • Cannot be changed later
Choose carefully! The slug cannot be changed after creation.
3

Select a plan

Start with the Hobby (free) plan or choose a paid tier
  • Hobby: Perfect for trying Alph and personal projects
  • Pro: For professional data scientists
  • Expert: For teams with advanced needs

Compare plans

See detailed pricing and features

​
Profile Settings

Customize your personal profile to help teammates identify you and control your preferences.

​
Profile Information

Navigate to your Account Settings to update:
  • Display name: How you appear to other users
  • Email: Your contact email (verified)
  • Avatar: Profile picture (from GitHub or custom upload)
  • Bio: Optional description of yourself

​
Preferences

Configure default behaviors:
  • Default theme: Light, dark, or system preference
  • Editor settings: Font size, tab width, vim mode
  • Notification preferences: Email and in-app notifications

​
Organization Settings

As an organization owner or admin, you can configure organization-wide settings.

​
Basic Information

  • Organization name
  • Description and logo
  • Public profile visibility

​
Member Management

Control who can access your organization:
  • Invite members by email
  • Set default member role
  • Configure join approval requirements

Managing members

Learn about roles and permissions

​
Integrations

Connect external services:
  • GitHub: Import and sync notebooks from repositories
  • Slack (coming soon): Receive notifications
  • API keys: Manage programmatic access

GitHub setup

Connect your GitHub repositories

​
Multiple Organizations

You can be a member of multiple organizations or create additional ones.

​
Creating Additional Organizations

  1. Click your profile menu in the top right
  2. Select Create Organization
  3. Follow the same setup process

​
Switching Between Organizations

Use the organization switcher in the navigation bar to move between workspaces you have access to.

​
Security Best Practices

  • Enable two-factor authentication (2FA) on your GitHub account if using OAuth
  • Use a strong, unique password if using email authentication
  • Never share your credentials
  • API tokens provide full access to your account
  • Rotate tokens regularly
  • Delete unused tokens immediately
  • Regularly review organization members
  • Remove access for departing team members
  • Use appropriate roles (don’t make everyone an owner)
  • Keep notebooks with sensitive data private
  • Review permissions before publishing
  • Use organization-level privacy for team notebooks

​
Next Steps

Create your first notebook

Start building with Jupyter notebooks

Invite your team

Add collaborators to your organization

Connect GitHub

Import existing notebooks from repositories

Set up billing

Upgrade your plan or add payment methods