Getting Started

Download and Launch

Pyodios app logo Pyodios app logo

Pyodios is available on the App Store. Tap the badge below to download:

Download on the App Store

Once installed, tap the Pyodios icon on your home screen to open the app. On first launch, you’ll see a loading screen with a progress bar while the Pyodide runtime initializes. This takes 5–15 seconds.

Subsequent launches are faster because your device caches the initialized Pyodide runtime.

Try Your First Python Command

Once loading completes, you land on the Notebook tab, a blank canvas ready for Python code. Create a new code cell and type the following, then tap the button to run it:

print("Hello, Pyodios!")
x = 42
x

Notice how the output appears inline beneath the cell: printed text, return values, and any errors are displayed directly in the notebook.

The flow: Start with a blank notebook, type Python code in a cell, tap run, and see the output inline. Print statements, return values, and errors each appear directly below the cell.

Now try adding a second cell with some math:

import math
print(f"sqrt({x}) = {math.sqrt(x):.4f}")
print(f"pi = {math.pi:.6f}")

Create Your First Plot

Ready to visualize data? Type the following in a new code cell and tap :

import matplotlib.pyplot as plt
import numpy as np

x = np.linspace(0, 2 * np.pi, 100)
plt.figure(figsize=(8, 4))
plt.plot(x, np.sin(x), label="sin(x)", linewidth=2)
plt.plot(x, np.cos(x), label="cos(x)", linewidth=2)
plt.title("Trigonometric Functions")
plt.xlabel("x")
plt.ylabel("y")
plt.legend()
plt.grid(True, alpha=0.3)
plt.show()

The plot renders inline in your notebook. You can also switch to the Plots tab to see all your visualizations. Pinch to zoom and tap to share.

Install a Package

Want more capabilities? Go to the Packages tab and install from PyPI via micropip:

  1. Open the Packages tab (under More on iPhone) with the Installed segment selected
  2. In the Install Package via micropip section at the top, type a package name (e.g., pandas)
  3. Tap Install

The installed package then appears in the Installed Packages list below.

You can also install packages programmatically by running import micropip; await micropip.install("pandas") in a notebook cell or the Console.

Not all PyPI packages are available. Only pure-Python packages or those with Pyodide WebAssembly builds are supported. Most popular packages like numpy, pandas, matplotlib, scipy, and scikit-learn are available. Check the Pyodide package list for the full list.

Explore the App

Pyodios has ten main sections, accessible from the tab bar and menus:

Notebook

Jupyter-compatible notebooks with code cells, markdown rendering, and inline output for an interactive workflow.

Editor

Write Python scripts with Tree-Sitter syntax highlighting, code outline, folding, and snippets.

Console

Interactive Python REPL with command history, code completion, and color-coded output.

Plots

View, zoom, and export your matplotlib and Plotly visualizations. Pin favorites and share via the system share sheet.

Environment

Inspect your Python workspace: see variables, DataFrames, and their values at a glance.

Files

Browse, create, import, and export Python scripts and notebooks with iOS Files app integration.

Packages

Install Python packages from PyPI via micropip. Offline wheel caching keeps packages available without a network.

Themes

Nine built-in color themes plus a full theme editor. Create, import, and export custom themes, and override the accent color.

Remote Kernels

Connect to a Jupyter server over the network and run code on a remote Python kernel instead of the local Pyodide runtime.

Settings

Configure layout, editor preferences, keyboard shortcuts, iCloud sync, plot display, and more.