Skip to content
Value Flows 'vf' vocabs
Branch: master
Clone or download
Pull request Compare This branch is 669 commits behind valueflows:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

Value Flows vocab

This is the "parent" repository for a set of interconnected vocabularies to describe flows of economic resources of all kinds within distributed economic ecosystems.

Purpose: to enable internetworking among many different software projects for resource planning and accounting within fractal networks of people and groups.

Or, if that is too many buzzwords, "let's help a lot of alternative economic software projects that are solving different pieces of the same puzzle be able to work together".

We wrote up a set of principles for what we are trying to do here.

Some of the "children" have been separated out into their own repositories to give them more attention:

Might be more to come. But this repository has the whole family.


This effort began in a conversation between the Network Requirements Planning (NRP), and the Open Apps software projects.

The NRP gang kept running into other apps that did a lot of the same things, or at least parts of the same things, that were used by different groups who wanted to collaborate with each other. So, let's have the different apps be able to collaborate with each other!

And the Open Apps gang (which includes the NRP gang) wants to create "a suite of integrated and open sourced apps which support transparent, democratic and decentralised organising".

Which potentially means many different apps that want to talk to each other. Thus the desire for a common vocabulary.

If you would like to be part of this conversation, please raise an issue here, or fork this or any of the related repositories and issue pull requests.

Who uses this?

NRP is the source of much of the vocabulary, and continues to refine the model, collaborating with user networks like Sensorica. Holodex is using the organization aspects of the vocab.

But most of the vocabulary comes from the Resource-Event-Agent (REA) ontology originated by Professor William McCarthy of Michigan State University in 1982, used in many places around the world.



Resource flows

One of the purposes of this vocab is to support resource flows connecting many websites. These flows may be oriented around Processes, Exchanges, or combinations of both. We are breaking out the Processes and Exchanges into their own vocab repositories, but here some overview diagrams.

In general, processes and exchanges alternate in a flow. But in some situations, either the processes or the exchanges are more important, and the other is not worth tracking and can be elided.

Process-oriented flow

process-oriented flow

Exchange-oriented flow

process-oriented flow

Process-Exchange combination flow

combo flow


You can’t perform that action at this time.