Skip to main content

​
Notebook Visibility

Every Alph notebook has a visibility setting that controls who can view it.

​
Visibility Options

Private

Who can see it:
  • You (the owner)
  • Organization members (if owned by org)
Use for:
  • Work in progress
  • Sensitive data
  • Internal analysis

Public

Who can see it:
  • Anyone with the link
  • Appears in public search
  • Listed on your public profile
Use for:
  • Tutorials and guides
  • Portfolio pieces
  • Sharing with community

​
Making a Notebook Public

1

Open notebook settings

Click the Settings icon in the notebook toolbar
2

Change visibility

Toggle the Public switch to make your notebook discoverable
3

Add metadata

Enhance discoverability with:
  • Description: Brief summary of the notebook
  • Tags: Relevant keywords (e.g., “machine-learning”, “tutorial”)
  • Thumbnail: Custom preview image (optional)
4

Save and publish

Click Save - your notebook is now public!
Public notebooks help build your portfolio and contribute to the data science community!

​
Sharing Methods

Copy the direct link to share your notebook: Private notebooks: 
https://runalph.ai/org-slug/~/notebooks/notebook-slug
Recipients must be organization members to view. Public notebooks: 
https://runalph.ai/notebooks/notebook-id
Anyone with the link can view.

​
Embed in Websites

Embed public notebooks in your website or blog: 
<iframe
  src="https://runalph.ai/embed/notebooks/notebook-id"
  width="100%"
  height="600px"
  frameborder="0"
>
</iframe>

​
Share on Social Media

Click the Share button for one-click sharing to:
  • Twitter/X
  • LinkedIn
  • Reddit
  • Hacker News
Generates a preview card with your notebook’s title, description, and thumbnail.

​
Organization Sharing

Share notebooks within your organization for team collaboration.

​
Organization Notebooks

Notebooks owned by an organization:
  • Visible to all organization members
  • Can be edited by members with appropriate permissions
  • Don’t count against personal quotas
  • Managed by organization admins

​
Transferring Ownership

Transfer a personal notebook to your organization:
  1. Open notebook settings
  2. Click Transfer Ownership
  3. Select the target organization
  4. Confirm transfer
Ownership transfer is permanent. The notebook will belong to the organization, not you personally.

​
Exporting Notebooks

Download notebooks in various formats for offline use or sharing.

​
Export Formats

  • .ipynb (Jupyter)
  • HTML
  • PDF
  • Markdown
  • Python
Standard Jupyter format
  • Preserves all cells and outputs
  • Compatible with Jupyter, VS Code, Colab
  • Can be uploaded to other platforms
Click: File → Download as → Jupyter Notebook (.ipynb)

​
Collaboration Features

​
Comments

Add comments to notebooks for feedback and discussion:
  1. Select any cell
  2. Click the Comment icon
  3. Write your comment
  4. Tag teammates with @mentions
Comments are visible to all organization members.

​
Version History

Alph automatically saves notebook versions:
  • Every significant change is versioned
  • View past versions in the History panel
  • Compare changes between versions
  • Restore previous versions if needed

Coming soon

Git-based version control integration for full diff and merge capabilities

​
Discovery and SEO

Help others find your public notebooks.

​
Optimization Tips

Good: “Predicting Housing Prices with Random Forest” Bad: “Notebook 1”Clear titles help both human readers and search engines.
Include:
  • What the notebook does
  • What techniques are used
  • What readers will learn
  • Prerequisites (if any)
Aim for 1-2 sentences that sell the value.
Use specific, searchable tags:
  • Languages: “python”, “r”, “julia”
  • Libraries: “pandas”, “tensorflow”, “pytorch”
  • Topics: “nlp”, “computer-vision”, “time-series”
  • Level: “beginner”, “intermediate”, “advanced”
Maximum 10 tags per notebook.
Public notebooks should have:
  • Introduction explaining the goal
  • Section headers organizing content
  • Explanations of key steps
  • Conclusions summarizing results
Well-documented notebooks rank higher in search.
Upload a preview image that represents your notebook:
  • Recommended size: 1200x630px
  • Shows visualization or key result
  • Displayed in search results and social shares

​
Notebook Analytics

Track engagement with your public notebooks:
  • Views: Total number of views
  • Unique visitors: Individual users who viewed
  • Copies: Times your notebook was copied
  • Stars: Users who favorited your notebook
  • Time on page: Average reading time
View analytics in the notebook settings panel.

​
Finding Notebooks

Discover notebooks from other users. Alph uses AI-powered semantic search:
  1. Go to the Notebooks public page
  2. Enter your search query
  3. Results ranked by relevance using vector embeddings
Example queries:
  • “sentiment analysis with transformers”
  • “exploratory data analysis customer churn”
  • “time series forecasting LSTM”

Learn more

Understand how semantic search works

​
Browse by Tag

Filter notebooks by tags:
  1. Click Browse Tags on the notebooks page
  2. Select tags of interest
  3. View notebooks matching those tags
Discover popular notebooks:
  • Trending: Recently popular based on views and engagement
  • Top Rated: Highest community ratings
  • New: Recently published notebooks
  • Featured: Curated by Alph team

​
Best Practices for Public Notebooks

  • Remove debug print statements
  • Delete failed experiments
  • Ensure all cells run top-to-bottom
  • Clear unnecessary outputs
Check that your notebook doesn’t contain:
  • API keys or credentials
  • Personal information
  • Proprietary data
  • Internal system details
Use environment variables for secrets.
Before publishing:
  1. Restart kernel
  2. Run all cells from top to bottom
  3. Verify all outputs appear correctly
  4. Ensure no errors occur
Reproducible notebooks are more valuable.
Specify usage rights in a markdown cell:
  • MIT: Permissive, allows commercial use
  • CC-BY: Requires attribution
  • CC-BY-NC: Non-commercial only
Example:
## License
This notebook is licensed under [MIT License](https://opensource.org/licenses/MIT)
Include links to datasets used:
  • Where to download the data
  • Data license and attribution
  • Data preprocessing steps
Helps others reproduce your work.

​
Privacy Considerations

​
What’s Shared

When you make a notebook public, others can see:
  • All code cells
  • All markdown cells
  • All cell outputs
  • Notebook metadata (title, description, tags)
  • Your username and profile

​
What’s Not Shared

Public notebooks do NOT expose:
  • Your email address
  • Organization details (unless mentioned in content)
  • Private notebooks
  • Project/kernel details
  • Environment variables

​
Making a Public Notebook Private

Change visibility at any time:
  1. Open notebook settings
  2. Toggle Public to off
  3. Notebook is immediately removed from public listings
Users who previously accessed the public link will lose access.

​
Publishing Checklist

Before publishing your notebook, verify:
1

Content review

  • No sensitive data or credentials
  • All cells execute without errors
  • Outputs display correctly
  • Markdown documentation is complete
2

Metadata

  • Descriptive title
  • Informative description
  • Relevant tags added
  • Custom thumbnail (optional)
3

Quality

  • Code is well-commented
  • Reproducible from top to bottom
  • Data sources provided
  • License specified
4

Final check

  • Preview how it looks to others
  • Test the public link
  • Share with the community!

​
Next Steps

Search & Discovery

Find notebooks from the community

GitHub Integration

Import and sync notebooks from GitHub