Skip to main content

​
Overview

Alph integrates deeply with GitHub — import notebooks from repos, sync changes bidirectionally with cell-level diffs, and view any public notebook without cloning. Important: Imported and synced notebooks live in Alph. They’re full Alph notebooks with AI assistance, execution, and publishing. The GitHub connection is for syncing content — the notebook itself is hosted on the platform. The gitalph.com viewer is separate — it renders notebooks directly from GitHub for quick viewing without importing.

​
Connecting GitHub

1

Go to Integrations

From your organization settings, click Integrations
2

Connect GitHub

Click Connect GitHub and authorize the Alph GitHub App
3

Select repositories

Choose which repos to give Alph access to

​
Importing Notebooks

  1. Go to Notebooks → Import → From GitHub
  2. Browse your connected repositories
  3. Select notebooks to import (single or bulk)
  4. Set title, visibility, and tags
  5. Click Import
Once imported, the notebook is an Alph notebook. Edit it with AI, execute code, publish it — everything works. You can also drag-and-drop .ipynb files directly.

​
Bidirectional Sync

Once a notebook is connected to a GitHub repo, changes flow both ways. Pull — fetch the latest version from GitHub into Alph. Push — commit your changes back to the repo. You can push directly to a branch or open a pull request with a custom commit message. Status indicators show when your notebook is ahead (local changes), behind (remote changes), or both (needs merge).

​
Cell-Level Diffs

Before pulling or pushing, review exactly what changed — cell by cell.
  • Added, removed, and modified cells are color-coded
  • Source code shows line-by-line unified diffs
  • Output changes are displayed side-by-side
  • Markdown cells show rendered previews
This isn’t a raw JSON diff. It’s a structured comparison that understands notebook semantics.

​
Auto-Sync

Sync stays active by default. You can pause it (unsync) and resume later (reconnect) without losing the GitHub connection.

​
GitHub Notebook Viewer

Any public GitHub notebook is available in Alph. Just swap github.com for gitalph.com in the URL: 
github.com/owner/repo/blob/main/notebook.ipynb
  → gitalph.com/owner/repo/blob/main/notebook.ipynb
This isn’t just a viewer — it’s a full Alph notebook. Connect a project and execute cells, use AI assistance, chat about the code. Every .ipynb on GitHub is one URL swap away from being a live, runnable notebook.

​
Managing Access

  • Add repos: Integrations → GitHub → Configure
  • Disconnect: GitHub Settings → Applications → Uninstall Alph