A modern versioning system for Artificial Intelligence projects.
ModelSync is a distributed version control tool inspired by Git, but entirely focused on the Artificial Intelligence ecosystem.
While Git is great for versioning code, it fails when dealing with:
- 🗂️ Large datasets
- 🧠 Trained models (binaries)
- 🧪 Experiments with multiple parameters
- 📈 Performance metrics and comparisons
The goal of ModelSync is to fill this gap, offering a data and experiment-oriented versioning environment.
| Component | Technology |
|---|---|
| CLI | Typer |
| API | FastAPI |
| Server | Uvicorn |
| Git | GitPython |
| Data | Pandas |
| Container | Docker |
modelsync init→ Initializes a.modelsync/repositorymodelsync commit -m "message"→ Saves a snapshot with metadata- Simple versioning with file hashing
- Basic API for queries and external interactions
- Python 3.10+
- Linux, macOS or Windows (WSL recommended)
git clone https://github.com/your-username/modelsync.git
cd modelsync
pip install -r requirements.txt# Initialize ModelSync repository
python modelsync/cli/main.py init
# Create a commit with message
python modelsync/cli/main.py commit -m "Model with 92% accuracy"| Command | Description |
|---|---|
modelsync init |
Creates a new ModelSync repository |
modelsync status |
Shows the status of tracked files and changes |
modelsync add [file] |
Adds a file to the staging area |
modelsync add . |
Adds all files to the staging area |
modelsync commit -m "[message]" |
Saves changes with a descriptive message |
modelsync log |
Shows commit history |
modelsync log --oneline |
Shows commit history in one line per commit |
modelsync diff |
Shows differences between working directory and staging area |
| Command | Description |
|---|---|
modelsync dataset add ./data.csv --name "Training Data" |
Add dataset to version control |
modelsync model add model.pkl --framework sklearn --metrics '{"accuracy": 0.95}' |
Add model to version control |
modelsync experiment create feature_engineering |
Create experiment branch |
modelsync llm start |
Start vLLM API server |
modelsync llm generate --prompt "Hello world" |
Generate text with vLLM |
modelsync llm_status |
Check vLLM service status |
modelsync web |
Start web interface |
| Command | Description |
|---|---|
modelsync restore [file] |
Discards changes in a file |
modelsync reset [file] |
Unstages a file from the staging area |
modelsync branch [name] |
Creates a new branch for experiments |
modelsync checkout [branch] |
Switches to another branch |
modelsync merge [branch] |
Merges changes from a branch |
modelsync remote add [name] [url] |
Adds a remote repository |
modelsync push |
Uploads changes to remote repository |
modelsync pull |
Downloads updates from remote repository |
modelsync clone [url] |
Clones a remote ModelSync repository |