This release is a pre-release and may not be stable for production use.
TICO (Torch IR to Circle ONE) is a Python library that converts PyTorch modules into Circle models — a lightweight and efficient representation in ONE designed for optimized on-device neural network inference.
Highlights
- One-call conversion —
tico.convert()turns annn.Moduleinto a ready-to-deploy.circlebinary. .pt2support — convert savedtorch.exportprograms via the Python API or thept2-to-circlecommand-line tool.- Run Circle models in Python — execute converted models directly for quick parity checks against PyTorch.
- Quantization toolkit — a unified
prepare/convertAPI with GPTQ, PTQ (WrapQ), SmoothQuant, SpinQuant, and CLE, plus config-driven CLI recipes for LLMs and VLMs.
Installation
Prerequisites
- Python 3.10+
- (Optional) one-compiler — only required to run inference with converted Circle models. Conversion itself does not need it.
We highly recommend using a virtual environment (e.g., conda, venv).
From PyPI
pip install tico
From source
git clone https://github.com/Samsung/TICO.git
cd TICO
./ccex build # generates build/ and dist/
./ccex install # installs the package
./ccex install options
| Option | Description |
|---|---|
--dist |
Install from the built wheel (default is editable mode) |
--torch_ver <ver> |
Torch version to install: a family (2.5 ~ 2.10), an exact version (e.g. 2.7.0+cu118), or nightly. Default: 2.7 |
--cuda_ver <maj.min> |
Override the detected CUDA version (e.g. 12.1) |
--cpu_only |
Force a CPU-only Torch installation |
Quick start
import tico
import torch
class AddModule(torch.nn.Module):
def forward(self, x, y):
return x + y
torch_module = AddModule()
example_inputs = (torch.ones(4), torch.ones(4))
circle_model = tico.convert(torch_module.eval(), example_inputs)
circle_model.save('add.circle')
[!NOTE] Call
eval()on the module before conversion. TICO internally usestorch.export, so the module must be export-able.
Converting a saved .pt2 file from the command line:
pt2-to-circle -i add.pt2 -o add.circle
See the Getting Started guide for compile configurations,
.pt2 conversion, and running Circle models directly in Python.
Quantization
The tico.quantization module provides a unified,
modular interface for quantizing neural networks — including large language models —
through a simple two-step prepare → convert workflow:
from tico.quantization import prepare, convert
from tico.quantization.config.gptq import GPTQConfig
prepared_model = prepare(model.eval(), GPTQConfig())
for d in dataset: # calibration
prepared_model(d)
quantized_model = convert(prepared_model, GPTQConfig())
- Quantization overview — API, architecture, and how to add a new algorithm
- Quantization algorithms — GPTQ, SmoothQuant, SpinQuant, CLE, …
- Config-driven CLI examples — quantize, evaluate, and inspect LLM/VLM recipes from the command line
Documentation
For users
| Document | Description |
|---|---|
| Getting Started | Converting modules and .pt2 files, compile configuration, running Circle models in Python |
| Quantization | The prepare/convert quantization API and toolkit |
| Quantization examples | Command-line quantization, evaluation, and debugging workflows |
For developers
| Document | Description |
|---|---|
| Development guide | Environment setup, testing, and code formatting with ./ccex |
| System design | Architecture, pass pipeline, invariants, and behavior design |
| Requirements | Functional and non-functional requirements |
| System tests | System-level test coverage |
Contributing
Contributions are welcome! For quantization algorithms, start with the quantization contribution guide and the recipes developer guide. Before submitting a PR, set up the development environment and run the tests and formatter as described in the development guide.
License
Licensed under the Apache License 2.0 — see LICENSE.
1 maintainer
Release files for tico 0.2.0.dev260706
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| tico-0.2.0.dev260706.tar.gz | 564.3 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| tico-0.2.0.dev260706-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.5 MB
Release files / tico-0.2.0.dev260706.tar.gz
| Download URL | tico-0.2.0.dev260706.tar.gz |
|---|---|
| Size | 564.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
b49b995380a15ec550bae46ea9ef60416b0ac62c7f3090eabdedb31cbe94b788
|
|
BLAKE2b-256 checksum How to use checksums |
246e9d04ce38fbb1fa87730404648c0af86bd28ab681ae7e65462b5a62d49bf9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 6, 2026.
Transparency logRelease files / tico-0.2.0.dev260706-py3-none-any.whl
| Download URL | tico-0.2.0.dev260706-py3-none-any.whl |
|---|---|
| Size | 953.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
8dfc23f63505578f48baa015336a3d6a1a845ac562ae42eb6dfb813afc14f107
|
|
BLAKE2b-256 checksum How to use checksums |
56a64d6cf8217837dc9c7045c4465e80c9e82bd68870686b1bf6b44cf85201de
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 6, 2026.
Transparency log
