Get started with the Eventual ev SDK in just 5 minutes. This guide will walk you through installation, configuration, and running your first job.

​
Prerequisites

Python

Python 3.8 or higher installed on your system

Account

An Eventual account - sign up here

​
Step 1: Install the ev SDK

pip install ev-sdk

​
Step 2: Authenticate

Authenticate using your browser (no API keys to manage): 
ev auth login
This will open your browser to complete the login process. Once authenticated, verify everything is working: 
ev --version
ev auth status

​
Step 3: Create Your First Job

Create a new file called hello_world.py: 
from ev import Env, Job

env = Env("3.11")
job = Job("hello-world", env)

@job.main()
def hello(name: str):
    print(f"Hello, {name}! Welcome to Eventual.")
    return f"Greeting sent to {name}"

​
Step 4: Run Your Job

Run your job using the ev CLI: 
ev run ./hello_world.py -- --name="World"
The -- separates ev CLI arguments from your job’s arguments. Your job will automatically run on distributed infrastructure.

​
Step 5: Monitor Your Job

ev jobs list

​
🎉 Congratulations!

You’ve successfully run your first Eventual job! Your job automatically:

Scaled

Ran on distributed infrastructure without any configuration

Logged

Captured logs and metrics for monitoring and debugging

Handled Errors

Included built-in retry and error handling capabilities

Optimized

Used optimized execution paths for your workload

​
Next Steps

Now that you’ve run your first job, here’s what to explore next:

Core Concepts

Learn about Jobs, Environments, and Resources

Image Processing

Process images at scale with ML models

Working with Data

Learn how to use daft for data processing

Advanced Features

Add dependencies and configure environments

​
Common Issues

Make sure you’ve run ev auth login and completed the browser authentication. Check your status with ev auth status.
Ensure you’ve installed the ev SDK with pip install ev-sdk. If you’re using a virtual environment, make sure it’s activated.
Check that your Python version is 3.8 or higher with python --version. Also ensure your job function has the correct signature.
Need help? Check out our troubleshooting guide or reach out to support@eventualcomputing.com.