neuml

txtinstruct: Build Instruction-Tuned Models with txtai

txtinstruct is a Python framework built on txtai for creating instruction-following datasets and training instruction-tuned models. It is aimed at teams that want to use their own data and prioritize clearer data and model licensing.

ArchivedPythonApache-2.0AILLMFramework
View on GitHub Compare
Stars
238
Forks
11
Stars, last 30 days
+0
Last commit
3.1 years ago
Contributors
1

Our take

Archivedarchived by its owners on GitHub, read-only

Health score

16/100

How it is scored
Activity
19
Community
4
Issues
21
Pull requests
20

+0 stars in the last 30 days

  • Fewer contributors than 91% of the projects we track

This is a focused framework for building instruction-tuning datasets and models, but its archived, read-only status makes it unsuitable as a maintained foundation for new production work.

Good fit if

  • You want to inspect an example of a txtai-based instruction-tuning workflow.
  • You need a starting point for experimenting with your own instruction data and can maintain the code yourself.
  • Apache-2.0 licensing suits your project.

Look elsewhere if

  • You need ongoing maintenance, since the repository is archived and has had no recent commits or releases.
  • You need active issue handling or a broader contributor base. The project has no recent issue closures and development was concentrated in one contributor.
  • You require a maintained training framework with documented support for particular hardware or deployment environments.
All health signals
Last commit2023-09-23 (3.1 years ago)
Commits, last 90 days0
Releases, last 12 months0 (latest v0.1.0, 2023-06-26)
Contributors1
Issues closed, last 90 days0
Pull requests merged, last 90 days0
Project age3 years

Checked on 2026-11-02 with the GitHub API.

Project history

Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.

Selected snapshot

Stars

238

Forks

11

Change since Nov 21, 2026: 0 stars·0 forks

Overview

txtinstruct is a Python framework built on txtai for creating instruction-following datasets and training instruction-tuned models. It addresses the lack of licensing clarity around instruction datasets and language models by helping teams build datasets from their own data and use them to train models.

The project is intended for people who want to work with open data and models rather than rely solely on existing instruction-tuning datasets. It includes an example notebook that walks through building datasets and models.

Key Features

  • Create instruction-following datasets from your own data.
  • Use those datasets to train instruction-tuned models.
  • Built with Python 3.8+ and txtai.
  • Includes an introductory notebook covering dataset and model creation.
  • Provides installation through PyPI or directly from GitHub.
  • Focuses on making dataset and model licensing clearer through user-controlled data.

Use Cases

  • Researchers can turn domain-specific material into instruction-following datasets for model training.
  • Teams with internal or specialized data can explore instruction-tuning without depending on a particular public dataset.
  • Developers evaluating instruction-tuning workflows can use the introductory notebook as a starting point.

What you need

Detected in the repository

  • Python (from pyproject.toml)

License in plain words

Apache-2.0permissive

  • Commercial use: yes
  • Modify and redistribute: yes
  • You must keep: the license, the NOTICE file and a note of your changes
  • Share your changes: no
  • Includes an explicit patent grant from the contributors:

A summary, not legal advice: the LICENSE file is what applies.

Getting Started

Install from PyPI:

pip install txtinstruct

See the README for the GitHub installation option and introductory notebook.

Alternatives

  • LlamaFactory: LlamaFactory focuses on fine-tuning and deploying models across many tasks, rather than creating instruction datasets as a central workflow.
  • EasyInstruct: EasyInstruct focuses on generating and filtering instruction data and building prompts, rather than training instruction-tuned models.
ProjectLanguageLicenseStarsStatus
txtinstructPythonApache-2.0238Archived
LlamaFactoryPythonApache-2.075.3kActive
EasyInstructPythonMIT407Inactive

Considerations

The repository is archived and read-only, with no recent commits and no release in over a year. Development was concentrated in one contributor, and there has been no recent issue or pull request activity. The README specifies Python 3.8+ and txtai, but does not document hardware requirements or a maintained support path. Apache-2.0 applies; review its terms for your intended use.

Found this useful?

Share it with someone who would like txtinstruct.

Comparisons