Package: luigi
NoteFor the latest source, discussion, etc, please visit theGitHub repositoryLuigi is a Python (3.6, 3.7, 3.8, 3.9, 3.10, 3.11 tested) package that helps you build complex
pipelines of batch jobs. It handles dependency resolution, workflow management,
visualization, handling failures, command line integration, and much more.Getting StartedRunpip install luigito install the latest stable version fromPyPI.Documentation for the latest releaseis hosted on readthedocs.Runpip install luigi[toml]to install Luigi withTOML-based configssupport.For the bleeding edge code,pip installgit+https://github.com/spotify/luigi.git.Bleeding edge documentationis also available.BackgroundThe purpose of Luigi is to address all the plumbing typically associated
with long-running batch processes. You want to chain many tasks,
automate them, and failureswillhappen. These tasks can be anything,
but are typically long running things likeHadoopjobs, dumping data to/from
databases, running machine learning algorithms, or anything else.There are other software packages that focus on lower level aspects of
data processing, likeHive,Pig, orCascading. Luigi is not a framework to
replace these. Instead it helps you stitch many tasks together, where
each task can be aHive query,
aHadoop job in Java,
aSpark job in Scala or Python,
a Python snippet,dumping a tablefrom a database, or anything else. It’s easy to build up
long-running pipelines that comprise thousands of tasks and take days or
weeks to complete. Luigi takes care of a lot of the workflow management
so that you can focus on the tasks themselves and their dependencies.You can build pretty much any task you want, but Luigi also comes with atoolboxof several common task templates that you use. It includes
support for runningPython mapreduce jobsin Hadoop, as well asHive,
andPig,
jobs. It also comes withfile system abstractions for HDFS,
and local files that ensures all file system operations are atomic. This
is important because it means your data pipeline will not crash in a
state containing partial data.Visualiser pageThe Luigi server comes with a web interface too, so you can search and filter
among all your tasks.Dependency graph exampleJust to give you an idea of what Luigi does, this is a screen shot from
something we are running in production. Using Luigi’s visualiser, we get
a nice visual overview of the dependency graph of the workflow. Each
node represents a task which has to be run. Green tasks are already
completed whereas yellow tasks are yet to be run. Most of these tasks
are Hadoop jobs, but there are also some things that run locally and
build up data files.PhilosophyConceptually, Luigi is similar toGNU
Makewhere you have certain tasks
and these tasks in turn may have dependencies on other tasks. There are
also some similarities toOozieandAzkaban. One major
difference is that Luigi is not just built specifically for Hadoop, and
it’s easy to extend it with other kinds of tasks.Everything in Luigi is in Python. Instead of XML configuration or
similar external data files, the dependency graph is specifiedwithin
Python. This makes it easy to build up complex dependency graphs of
tasks, where the dependencies can involve date algebra or recursive
references to other versions of the same task. However, the workflow can
trigger things not in Python, such as runningPig scriptsorscp’ing files.Who uses Luigi?We use Luigi internally atSpotifyto run
thousands of tasks every day, organized in complex dependency graphs.
Most of these tasks are Hadoop jobs. Luigi provides an infrastructure
that powers all kinds of stuff including recommendations, toplists, A/B
test analysis, external reports, internal dashboards, etc.Since Luigi is open source and without any registration walls, the exact number
of Luigi users is unknown. But based on the number of unique contributors, we
expect hundreds of enterprises to use it. Some users have written blog posts
or held presentations about Luigi:Spotify(presentation, 2014)Foursquare(presentation, 2013)Mortar Data (Datadog)(documentation / tutorial)Stripe(presentation, 2014)Buffer(blog, 2014)SeatGeek(blog, 2015)Treasure Data(blog, 2015)Growth Intelligence(presentation, 2015)AdRoll(blog, 2015)17zuoye(presentation, 2015)Custobar(presentation, 2016)Blendle(presentation)TrustYou(presentation, 2015)Groupon/OrderUp(alternative implementation)Red Hat - Marketing Operations(blog, 2017)GetNinjas(blog, 2017)voyages-sncf.com(presentation, 2017)Open Targets(blog, 2017)Leipzig University Library(presentation, 2016)/(project)Synetiq(presentation, 2017)Glossier(blog, 2018)Data Revenue(blog, 2018)Uppsala University(tutorial)/(presentation, 2015)/(slides, 2015)/(poster, 2015)/(paper, 2016)/(project)GIPHY(blog, 2019)xtream(blog, 2019)CIAN(presentation, 2019)Some more companies are using Luigi but haven’t had a chance yet to write about it:Schibstedenbrite.lyDow Jones / The Wall Street JournalHotels.comNewselaSquarespaceOAOGrovoWeeblyDeloitteStacktomeLINX+Neemu+ChaordicFoxberryOkkoISVWorldBig DataMovioBonnier NewsStarsky RoboticsBaseTISHopperVOYAGE GROUP/ZucksTextpertTrackticsWhizarxtreamSkyscannerJodelMekarM3Assist DigitalMeltwaterDevSamuraiVeridasWe’re more than happy to have your company added here. Just send a PR on GitHub.External linksMailing Listfor discussions and asking questions. (Google Groups)Releases(PyPI)Source code(GitHub)Hubot Integrationplugin for Slack, Hipchat, etc (GitHub)AuthorsLuigi was built atSpotify, mainly byErik BernhardssonandElias Freider.Many other peoplehave contributed since open sourcing in late 2012.Arash Rouhaniwas the chief maintainer from 2015 to 2019, and now
Spotify’s Data Team maintains Luigi.