{"id":27935,"library":"mage-ai","title":"Mage AI","description":"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).","status":"active","version":"0.9.79","language":"python","source_language":"en","source_url":"https://github.com/mage-ai/mage-ai","tags":["data-pipelines","etl","orchestration","data-engineering"],"install":[{"cmd":"pip install mage-ai","lang":"bash","label":"Install from PyPI"}],"dependencies":[],"imports":[{"note":"","wrong":"","symbol":"mage_ai","correct":"import mage_ai"},{"note":"","wrong":"","symbol":"init","correct":"from mage_ai.server.app import start"}],"quickstart":{"code":"import os\nfrom mage_ai.server.app import start\n\n# Set environment variables for authentication (optional)\nos.environ.get('MAGE_API_KEY', '')\n\n# Start Mage server\nstart()","lang":"python","description":"Start the Mage development server programmatically."},"warnings":[{"fix":"Use `uvicorn mage_ai.server.app:app --host 0.0.0.0 --port 6789` instead of calling start() in production.","message":"Mage's default server is designed for development; for production, use a production-grade ASGI server like uvicorn or gunicorn.","severity":"gotcha","affected_versions":">=0.9.0"},{"fix":"Run `mage init my_project` from the terminal, not from Python.","message":"The `init` command is not available inside Python code; it must be run from the CLI.","severity":"gotcha","affected_versions":">=0.9.0"},{"fix":"Upgrade to latest and use `mage_ai.data_preparation` for pipeline definitions.","message":"Older Mage versions used `mage_ai.orchestration` for pipeline execution; this has been restructured.","severity":"deprecated","affected_versions":"<=0.9.60"}],"env_vars":null,"last_verified":"2026-05-09T00:00:00.000Z","next_check":"2026-08-07T00:00:00.000Z","problems":[{"fix":"Run `pip install mage-ai` and ensure you're using the same Python environment (e.g., virtualenv, conda).","cause":"Mage is not installed or installed in a different environment.","error":"ModuleNotFoundError: No module named 'mage_ai'"},{"fix":"Upgrade to latest using `pip install --upgrade mage-ai` and use the correct import: `from mage_ai.server.app import start`.","cause":"The import path changed; older versions had a different structure.","error":"ImportError: cannot import name 'start' from 'mage_ai.server.app'"},{"fix":"Run `mage init project_name` in your terminal, not in Python.","cause":"Trying to run `mage init` as a Python function instead of a CLI command.","error":"AttributeError: module 'mage_ai' has no attribute 'init'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}