Getting started running on Zepl is fast and easy. This Test Flight guide will walk you through a complete example starting with your account sign-up and ending with running your first sample notebook connected to data in S3. The sample notebook takes the common Titanic disaster dataset and demonstrates how to run python code, create visualizations, and connect to to a Zepl data source. We will also call out additional Zepl notebook features around versioning, code snippets, and sharing.
If you haven't already, please sign up for a free Zepl trial. Zepl offers a free 30 day trial which comes with $100 in free Zepl credits. Credits allow you to run notebook containers and are only consumed while you are running code, so you are not charged for time that you are simply developing or viewing notebook results.
At any time during your trial, you can activate your Zepl account which gives you access to unlimited pay-as-you-go credit usage. This is our low cost, $25/month minimum payment and can be cancelled at any time. This can be completed all through the product, but if you have any questions, please reach-out to: [email protected]
If you have any existing Jupyter (.ipynb) or Apache Zeppelin (.json, .zpln) notebooks from previous projects, these can be easily imported from your local file system or from a public URL, such as Github or S3.
From the Zepl home page, Select the "+ Add New" button > Import Notebook
Notebook title: This will be filled in by the imported notebook but can always be changed later
Space: Select "My Notebooks"
Type: Select "Fetch From URL"
Link to your notebook:
Zepl has one click integrations with the most popular data warehouses. Zepl data sources enable you to securely connect to the data warehouse of your choice without ever exposing your personal credentials and allows you to reuse these connections in any notebook. View all of our data source connections below:
Most data science projects also start with local data files. You can easily work with and share local data files by uploading those to your notebook. Check out our File Upload documentation here:
In this step, we will provide you with access to a Zepl hosted S3 bucket with pre-loaded sample data.
Inside the notebook from Step 2, click the Data Source icon on the right side of the screen
Select "Add new" > Amazon S3
Complete the Data Source form
Description: "Getting started on Zepl"
Credential Type: Select "Private"
Access Key ID:
Secret Access Key:
Session Token: Leave this blank
Select Add - *Refresh the screen if required
Now that we have created and attached our S3 data source to the notebook, we will use Zepl's universal function to create the connection:
z.getDatasource("<Data Source Name>").
Scroll down to the paragraph labeled "Connect to your S3 Bucket"
The code required to connect to our S3 bucket is already added for you:
bucket = z.getDatasource("Titanic_Data") .
The value returned is a boto3 Bucket object (boto3.resources.factory.s3.Bucket), which has many functions for downloading and uploading files to S3. Please see our Amazon S3 reference below for more information.
Select the "Run" button in the top left corner to execute every paragraph or run each paragraph individually by select the small run icon in the right corner of each paragraph.
Select the "+ Add New" button > Invite New Members
Email: This will be the user name and email address where that user will receive their invite with temporary account credentials
Security Policies: See our security policy documentation
Navigate back to your notebook labeled Getting Started: ML on Titanic
In the notebook, Select Share
Enter the email of the new user you invited > Select Add
Set up Notebook Access Control: Documentation Here
Select Save Changes
Notebook versions are created automatically when paragraphs are executed, code is modified, or results change. Versions can also be named for easier identification and to act as a tagging system. Naming a version can also be used to create saved versions manually. And, of course, it's possible to rollback the notebook to any of the previous versions.
Notebooks can be scheduled to run on a consistent time schedule. Select from the prepopulated options (1h, 3h, 6h, etc.) or enter a cron schedule for full customization.
Zepl provides quick and easy navigation within your notebook by listing the titles of your paragraphs, language used in the paragraph, and any markdown tags. This can be accessed within your notebook by selecting the list icon on the upper right hand menu bar.
Use comments to leave feedback or ask questions on specific paragraphs. Leaving a comment will automatically notify all users with whom the notebook is shared.
Files such as .csv, .pkl, or other model files can be easily uploaded to a notebook. This can be done by selecting the folder icon on the right hand menu bar. Note that uploaded files cannot exceed 100mb per notebook.