Skip to main content

saga is a version control CLI that handles many file formats

Project description


Saga is a set of tools for version control. Saga is like Git, but it works for file formats other than text files. As a user, you can use saga to manage your creative projects. Currently, Saga supports unstructed binary files, text files, CSV files, and Excel files. Unlike Git, Saga can merge changes from different branches from any of these files (if they don't conflict).

As a developer, you can use the Saga framework to add version control to new file formats. See examples here and here. Documentation coming soon!

Installation Instructions

To install the saga command line tool, run:

pip3 install saga-vcs

Currently, Saga only works on macOS. Support for Linux and Windows is coming soon!

Using saga

Currently, the saga command line tool has a very similar interface to Git. The following commands are currently supported:

saga init
saga add 
saga commit
saga log
saga status
saga branch
saga checkout
saga merge

Some commands don't perform exactly as Git does, so watch out!


Saga is pre-alpha software. Do not use saga to manage any files that you don't totally trust (we are sure there are security vulnerabilities hanging about).

Downloading Saga Source

If you want to check out saga's source code (or contribute <3):

git clone;
cd saga;
python3 -m venv env;
source env/bin/activate;
pip install -r requirements.txt;

Running Tests

When inside of the python virtual enviorment:

python -m pytest

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for saga-vcs, version 0.0.13
Filename, size File type Python version Upload date Hashes
Filename, size saga_vcs-0.0.13-py3-none-any.whl (19.3 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size saga-vcs-0.0.13.tar.gz (15.2 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page