mage-ai

library0.9.79pypypi✓ verified 84d ago

Mage is a modern data pipeline tool for building, running, and managing data pipelines. It integrates with Python, SQL, and R, and provides a web-based UI for development and monitoring. Current version: 0.9.79. Release cadence: frequent (multiple releases per month).

data workflow web-framework

pip install mage-ai

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · MAGE-AI

mage-ai

datapythonv0.9.79

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

mage_ai

✓ import mage_ai

init

✓ from mage_ai.server.app import start

Start the Mage development server programmatically.

import os from mage_ai.server.app import start # Set environment variables for authentication (optional) os.environ.get('MAGE_API_KEY', '') # Start Mage server start()

mage --version

Debug

Known issues

gotchaMage's default server is designed for development; for production, use a production-grade ASGI server like uvicorn or gunicorn.

fix

Use `uvicorn mage_ai.server.app:app --host 0.0.0.0 --port 6789` instead of calling start() in production.

affects: >=0.9.0

gotchaThe `init` command is not available inside Python code; it must be run from the CLI.

fix

Run `mage init my_project` from the terminal, not from Python.

affects: >=0.9.0

deprecatedOlder Mage versions used `mage_ai.orchestration` for pipeline execution; this has been restructured.

fix

Upgrade to latest and use `mage_ai.data_preparation` for pipeline definitions.

affects: <=0.9.60

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'mage_ai'

Mage is not installed or installed in a different environment.

fix

Run `pip install mage-ai` and ensure you're using the same Python environment (e.g., virtualenv, conda).

ImportError: cannot import name 'start' from 'mage_ai.server.app'

The import path changed; older versions had a different structure.

fix

Upgrade to latest using `pip install --upgrade mage-ai` and use the correct import: `from mage_ai.server.app import start`.

AttributeError: module 'mage_ai' has no attribute 'init'

Trying to run `mage init` as a Python function instead of a CLI command.

fix

Run `mage init project_name` in your terminal, not in Python.

Upgrade

Version history

0.9.79latest on PyPI · released Jan 21, 2026

Audit

Dependencies

No dependency data recorded yet.

Agent activity

23 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/mage-ai/mage-ai ↗

packagehttps://pypi.org/project/mage-ai/ ↗

homepagehttps://www.mage.ai ↗