Skip to main content

A simple framework to deploy AI models locally with one command, no containers needed

Project description

tursi-ai

GitHub release

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)

  1. Clone the repo:
git clone https://github.com/BlueTursi/tursi-ai.git
cd tursi-ai
  1. Set up a virtual environment (required):
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate
  1. 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

MIT License

Acknowledgments

Built with 💙 using:

  • Transformers
  • Flask
  • PyTorch

Built by BlueTursi.

Project details


Download files

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

Source Distribution

tursi-0.2.1.tar.gz (5.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

tursi-0.2.1-py3-none-any.whl (6.4 kB view details)

Uploaded Python 3

File details

Details for the file tursi-0.2.1.tar.gz.

File metadata

  • Download URL: tursi-0.2.1.tar.gz
  • Upload date:
  • Size: 5.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.3

File hashes

Hashes for tursi-0.2.1.tar.gz
Algorithm Hash digest
SHA256 03d3a13179534c5cd56f21e6be00b5517f9150c58b08e29623fef45e55c06f76
MD5 31cfc7d29f997347f1b6f7df3bbf2349
BLAKE2b-256 5ed235117876ef7663c2ed4028c0f17e7a22026c535dd504941b2b1fef08af6f

See more details on using hashes here.

File details

Details for the file tursi-0.2.1-py3-none-any.whl.

File metadata

  • Download URL: tursi-0.2.1-py3-none-any.whl
  • Upload date:
  • Size: 6.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.3

File hashes

Hashes for tursi-0.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 21f017e2b8d270d292edf2a8ea08c22016291ef421460f90fddd52f8b648071f
MD5 e5db811b67b1ffd6e41770cbca53c960
BLAKE2b-256 8318d12b181e849c73708c0ec532ade4d25be1ded46d621973816128f82805a0

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page