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.0.tar.gz (5.3 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.0-py3-none-any.whl (6.0 kB view details)

Uploaded Python 3

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

Hashes for tursi-0.2.0.tar.gz
Algorithm Hash digest
SHA256 488154145c5d175d9fd6bc3529962dbcc7adc25aef221041a8ba2c87c0e9becc
MD5 e4ef771362c222a281d013381f717dd2
BLAKE2b-256 f185968e604a7b0e6c19e7e76f7151ec945096b288c3f33347a45c0efe4ac67b

See more details on using hashes here.

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

Hashes for tursi-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 042e761a9ac1ebce034ebac92d43621e22fedb327d3d953ce40ae57e9423179a
MD5 b8e2da63152c06a837a173cc7b9aed31
BLAKE2b-256 13908d7f99908aa133cffd59556279216988fc3dfa483ddd66474378191b1681

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