Skip to main content

saga is a version control CLI that handles many file formats

Project description


Saga is a version control tool like Git, but it can be used to version control files other than just text.

As a user, you can use currently use saga to manage your creative projects. Currently, saga includes basic support for unstructed binary files, text files, CSV files, and Excel files.

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:


Profiling a Test

python3 -m cProfile -m pytest tests/

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.17
Filename, size File type Python version Upload date Hashes
Filename, size saga_vcs-0.0.17-py3-none-any.whl (21.3 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size saga-vcs-0.0.17.tar.gz (17.7 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page