Skip to content

Latest commit

 

History

History
173 lines (122 loc) · 5.65 KB

README.md

File metadata and controls

173 lines (122 loc) · 5.65 KB

PyPi mage-ai License Join Slack

Intro

Mage is an open-source notebook for building and deploying ETL pipelines.

Mage

Join us on Slack

Table of contents

  1. Quick start
  2. Tutorials
  3. Features
  4. Contributing
  5. Community

🏃‍♀️ Quick start

Fire mage

You can install Mage using Docker or pip:

Using Docker

1. Clone repository
git clone https://github.com/mage-ai/mage-ai.git && cd mage-ai
2. Create new project
./scripts/init.sh [project_name]
3. Launch editor
./scripts/start.sh [project_name]

Open http://localhost:6789 in your browser and build a pipeline.

4. Run pipeline after building it in the tool
./scripts/run.sh [project_name] [pipeline]

Using pip

1. Install Mage
pip install mage-ai
2. Create new project
mage init [project_name]
3. Launch editor
mage start [project_name]

Open http://localhost:6789 in your browser and build a pipeline.

4. Run pipeline after building it in the tool
mage run [project_name] [pipeline]

👩‍🏫 Tutorials


🔮 Features

  1. Data centric editor
  2. Production ready code
  3. Extensible

1. Data centric editor

An interactive coding experience designed for preparing data to train ML models.

Visualize the impact of your code every time you load, clean, and transform data.

Data centric editor

2. Production ready code

No more writing throw away code or trying to turn notebooks into scripts.

Each block (aka cell) in this editor is a modular file that can be tested, reused, and chained together to create an executable data pipeline locally or in any environment.

Read more about blocks and how they work.

Production ready code

Run your data pipeline end-to-end using the command line function: $ mage run [project] [pipeline]

You can run your pipeline in production environments with the orchestration tools

3. Extensible

Easily add new functionality directly in the source code or through plug-ins (coming soon).

Adding new API endpoints (Tornado), transformations (Python, PySpark, SQL), and charts (using React) is easy to do (tutorial coming soon).

Extensible charts

New features and changelog

Check out what’s new here.

🙋‍♀️ Contributing

We welcome all contributions to Mage; from small UI enhancements to brand new cleaning actions. We love seeing community members level up and give people power-ups!

Check out the 🎁 contributing guide to get started by setting up your development environment and exploring the code base.

Got questions? Live chat with us in Slack Slack

Anything you contribute, the Mage team and community will maintain. We’re in it together!

🧙 Community

We love the community of Magers (/ˈmājər/); a group of mages who help each other realize their full potential!

To live chat with the Mage team and community, please join the free Mage Slack Slack channel.

Join us on Slack

For real-time news and fun memes, check out the Mage Twitter Twitter.

To report bugs or add your awesome code for others to enjoy, visit GitHub.

🪪 License

See the LICENSE file for licensing information.


Wind mage casting spell