flamenco/web/project-website/content/mission/_index.md

title	weight	aliases	resources
Mission & Design	1	/design-principles/	name src title components flamenco_components.png Flamenco Components

Flamenco is a lightweight, cross-platform framework to dispatch and schedule rendering jobs for smaller animation studios and individuals at home.

Target Audience

Flamenco is meant for smaller animation studios and individuals at home. Think of roughly 1-10 artists using it, and 1-100 computers attached to the farm to execute tasks. Blender Studio uses a handful of servers, and combines those with various desktop machines when they're not used by the artists.

There is no need to compile or build anything. The Flamenco project distributes executables and a Blender add-on for you to install and run ([downloads][downloads]).

[downloads]: {{< ref "/download/" >}}

Design Principles

The following principles guide the design of Flamenco:

Blender.org Project

Flamenco is a true blender.org project. This means that it's Free and Open Source, made by the community, lead by Blender HQ. Its development will fall under the umbrella of the Pipline, Assets & IO module.

Minimal Authentication & Organisation

Because Flamenco is aimed at small studios and individuals, it won't offer much in terms of user authentication, nor the organisation of users into groups. [Custom job types][jobtypes] can be used to attach arbitrary metadata to jobs, such as the submitter's name, a project identifier, etc.

[jobtypes]: {{< ref "/usage/job-types" >}}

Minimize External Components

Running Flamenco should be extremely simple. This means that it should depend on as few external packages as possible. Apart from the Flamenco components themselves, all you need to install is Blender.

The downside of this is that development might take longer, as some things that an external service could solve need to be implemented. This trade-off of developer time for simplicity of use is considered a good thing, though.

No Errors, Guide Users To Success

Instead of stopping with a description of what's wrong, like "no database configured", Flamenco should show something helpful in which you're guided towards a working system.

Customisable

Studio pipeline developers / TDs should be able to customise the behaviour of Flamenco. They should be able to create new [job types][jobtypes], and adjust existing job types to their needs. For this, Flamenco uses JavaScript to convert a job definition like "render this blend file, frames 1-100" into individual tasks for computers to execute.

Work offline

Like Blender itself, Flamenco should be able to fully work offline. That is, work without internet connection. If any future feature should need such a connection, that feature should always be optional, and be disabled by default.

Data Storage

Data should be stored as plain files whenever possible. Where a higher level of coordination is required, an embedded database can be used; currently Flamenco uses SQLite for this.

Supported Platforms

As the Blender.org project is built on free and Open Source software, Linux is the main platform Flamenco is developed against. Windows and MacOS will also be supported, but on a best-effort basis with help from the community.

Infrastructure

Setting up a render farm is not as simple as pushing a button, but Flamenco aims to keep things as simple as possible.

What you need to run Flamenco is:

• One or more computers to do the work, i.e. running Flamenco Worker. You'll probably also want to install Blender there.
• A computer to run the central software, Flamenco Manager. This could be one of the above computers, or a dedicated one.
• A local network with file sharing already set up, so that the above computers can all reach the same set of files.

{{< img name="components" size="small" lazy=false >}}