A simple framework to deploy AI models locally with one command, no containers needed
Project description
tursi-ai
A simple, lightweight framework to deploy AI models locally with a single command—no Docker, no external services required.
Overview
tursi-ai lets you run AI models (like text classification) on your machine with minimal setup. Our unique selling proposition: "AI deployment, one command, no containers needed." The base install is ~150-200MB, with an additional ~250MB for the default model on first run.
Features
- One-command deployment: Start a model server with a single script.
- No containers: Runs directly in your Python environment.
- Lightweight: Minimal dependencies, small footprint.
- Extensible: Built for easy customization and growth.
Getting Started
Prerequisites
- Python 3.8+ (tested with 3.12)
Installation
Install via PyPI:
pip install tursi
Or from source (for development)
- Clone the repo:
git clone https://github.com/BlueTursi/tursi-ai.git
cd tursi-ai
- Set up a virtual environment (required):
python -m venv venv
source venv/bin/activate # Windows: venv\Scripts\activate
- Install:
pip install .
Usage
1. Deploy a model:
tursi-engine up
Stop it with:
tursi-engine down
Customize:
tursi-engine up --model "distilbert-base-uncased-finetuned-sst-2-english" --host "127.0.0.1" --port 8080
2. Test the deployed model:
tursi-test --prompt "I love AI"
Or with a custom URL:
tursi-test --prompt "I love AI" --url "http://127.0.0.1:8080/predict"
Project Structure
tursi-ai/
├── tursi/ # Core package
│ ├── engine.py # Deployment script with CLI
│ └── test.py # Testing utility
├── LICENSE # MIT License
├── README.md # This file
├── requirements.txt # Dependencies
└── setup.py # PyPI setup
Roadmap
- Add more CLI commands (e.g., status, down).
- Support additional model types.
Contributing
Fork this repo, make changes, and submit a PR!
License
Acknowledgments
Built with 💙 using:
- Transformers
- Flask
- PyTorch
Built by BlueTursi.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file tursi-0.2.0.tar.gz.
File metadata
- Download URL: tursi-0.2.0.tar.gz
- Upload date:
- Size: 5.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
488154145c5d175d9fd6bc3529962dbcc7adc25aef221041a8ba2c87c0e9becc
|
|
| MD5 |
e4ef771362c222a281d013381f717dd2
|
|
| BLAKE2b-256 |
f185968e604a7b0e6c19e7e76f7151ec945096b288c3f33347a45c0efe4ac67b
|
File details
Details for the file tursi-0.2.0-py3-none-any.whl.
File metadata
- Download URL: tursi-0.2.0-py3-none-any.whl
- Upload date:
- Size: 6.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
042e761a9ac1ebce034ebac92d43621e22fedb327d3d953ce40ae57e9423179a
|
|
| MD5 |
b8e2da63152c06a837a173cc7b9aed31
|
|
| BLAKE2b-256 |
13908d7f99908aa133cffd59556279216988fc3dfa483ddd66474378191b1681
|