Model or dataset
ConardLi/easy-dataset avatar
ConardLi/easy-dataset

Easy Dataset: A GUI Pipeline for Turning Documents into LLM Training and Eval Sets

A powerful tool for creating datasets for LLM fine-tuning 、RAG and Eval

14,913 stars1,532 forksJavaScriptNOASSERTION

At a glance

What is it?
Easy Dataset is a desktop application for converting PDFs, Markdown, and other documents into structured datasets for fine-tuning, RAG, and evaluation. It bundles parsing, QA generation, and an eval harness, but its AGPL license and reliance on external LLM APIs shape where it fits.
Who is it for?
Adopt Easy Dataset if you need a visual, low-code way to turn domain documents into QA pairs or evaluation sets and you can run a desktop app. Skip it if you require a permissive license for redistribution, need to run dataset creation on a server without a GUI, or want to avoid sending document content to third-party LLM APIs.
Can I use it commercially?
Check first. The repository uses a licence we do not classify automatically, so read its LICENSE file before any commercial use.
Is it still maintained?
Yes. The repository last received commits 137 days ago.
What is it written in?
Mainly JavaScript, according to GitHub's language statistics.

Answers come from the project's GitHub data, last synced on September 15, 2026, and from our analysis. They are not legal advice.

DEEP OPEN-SOURCE ANALYSIS

What Easy Dataset Actually Solves

Building a fine-tuning dataset from raw documents is tedious. You have to parse PDFs, split text sensibly, write questions, generate answers, and then format everything for a trainer like LLaMA Factory. Easy Dataset is a desktop application that tries to automate that whole chain. It targets engineers and non-technical users who need structured QA data from domain-specific documents. The README lists three use cases: model fine-tuning, retrieval-augmented generation (RAG), and model evaluation. For RAG, the output is likely used to test retrieval quality, though the README does not detail how the exported data maps to a RAG benchmark. The tool also includes an evaluation system, so you can generate test questions and run model comparisons. That makes it a one-stop shop for dataset creation and assessment, which is unusual. Most open-source tools in this space do one side, either generation or evaluation, not both in a single GUI.

The Pipeline: From PDF to QA Pairs

The core workflow is visible from the feature list. You start by importing documents in PDF, Markdown, DOCX, TXT, or EPUB format. The tool applies intelligent text splitting, with multiple algorithms: Markdown structure, recursive separators, fixed length, and code-aware chunking. You can visually adjust the segmentation. Next, it generates questions from text segments using an LLM API, with templates and batch generation. A domain label tree is built from the document structure, and the tool auto-tags content. Then it generates answers, including Chain of Thought, again via LLM API. Finally, data cleaning removes noise. The README mentions a data distillation feature that generates label trees and questions directly from domain topics, without uploading documents. That suggests you can bootstrap a dataset from a topic list alone. The whole process depends on external LLM calls for question and answer generation. The tool does not train or host models; it orchestrates APIs. That is a key architectural point: the quality of your dataset is bounded by the underlying LLM you connect.

Running It: Desktop Clients and Local Setup

The primary way to run Easy Dataset is to download a desktop client. The README provides links for Windows, macOS (Intel and presumably Apple Silicon, though the table only shows Intel), and Linux. There is no Docker or server install mentioned. After installing, you point the app at your documents and configure an LLM API. The README says it is compatible with all LLM APIs that follow the OpenAI format, and lists providers: OpenAI, MiniMax, Ollama, Zhipu AI, Alibaba Bailian, OpenRouter. For vision tasks like PDF parsing and image QA, it supports Gemini and Claude. So the setup is: install the app, add an API key, choose a model, and start generating. There is no command-line interface described. That lowers the barrier for non-technical users but makes it awkward for automated pipelines. If you want to run dataset generation in a CI/CD loop, you would need a different tool.

Export Formats and Integration Points

The output side matters because a dataset is useless if your trainer cannot read it. Easy Dataset exports to Alpaca, ShareGPT, and Multilingual-Thinking formats, in JSON or JSONL. Alpaca and ShareGPT are common fine-tuning formats, so that covers most open-source training stacks. The tool also generates a LLaMA Factory configuration file with one click, which is a concrete integration. For RAG evaluation, you can export test sets with question types like true/false, single-choice, multiple-choice, short-answer, and open-ended. There is a balanced export feature that lets you configure export counts per tag, which helps avoid class imbalance in your dataset. You can also upload datasets directly to Hugging Face Hub. These integrations are practical. They reduce the glue code you would otherwise write. The Multilingual-Thinking format is less standard, but its presence suggests support for reasoning-style datasets. The README does not give an example of the exported JSON structure, so you should verify the schema matches your trainer's expectations before committing.

Built-In Evaluation: More Than a Dataset Creator

Version 1.7.0 added an evaluation system, which is a significant expansion. You can generate evaluation datasets from documents and then run automated evaluation using a Judge Model. That judge model scores answers based on customizable rules. There is also a human blind test system, called Arena, which compares two models' answers double-blind. This is useful for post-fine-tuning evaluation, vertical domain model assessment, and RAG recall rate evaluation, as the README states. The tool also includes an AI quality assessment that scores and filters generated datasets. That means you can use the same tool to create a test set and then evaluate a model against it. The evaluation feature is not just a side add-on; it is central to the project's identity. However, the README does not specify how the judge model is selected or whether it can be a local model via Ollama. Given the OpenAI-compatible API support, you could likely point the judge at any compatible endpoint, but that is an inference, not a documented fact.

Limitations and Cases Where It Is the Wrong Fit

The biggest limitation is the license. The README badge says AGPL-3.0, even though the repository metadata says NOASSERTION. AGPL is a strong copyleft license. If you build a service that uses Easy Dataset and you modify its source, you may have to release your changes. That is a dealbreaker for many commercial teams that want to embed dataset generation in a proprietary product. Even if you do not modify the code, linking or distributing it could trigger obligations. The README does not include a LICENSE file in the visible portion, so you should check the repository's actual license file before relying on it. Another limitation is the desktop-only model. There is no headless mode or API server. If you need to process thousands of documents in a batch on a server, a GUI tool is inefficient. The tool does have a task management center for background batch processing, but it still runs inside the desktop app. Also, the quality of generated questions and answers depends entirely on the LLM API you configure. The tool does not include a local generation model by default, except through Ollama integration. That means you need internet access or a local Ollama setup, and you incur API costs. Finally, the README claims support for many document formats, but parsing quality for complex PDFs is always a risk. You should test with your own files before assuming the output is clean.

Alternatives: How the Approach Differs

The most direct alternative is to use a library like LlamaIndex or LangChain to build a custom dataset generation pipeline. Those frameworks give you programmatic control over document loading, splitting, and LLM calls. You write Python code, which is more flexible but requires engineering effort. Easy Dataset offers a GUI and visual segmentation, which libraries do not. Another alternative is the dataset generation tools that come with fine-tuning frameworks, such as LLaMA Factory's own data preparation scripts, but those are usually less comprehensive. There is also the approach of manual dataset curation, using tools like Label Studio for annotation. That is a human-in-the-loop process, which is more accurate but slower and not automated. The key difference is that Easy Dataset combines generation and evaluation in a desktop app, while library-based approaches are code-first and often separate generation from evaluation. If you prefer a visual interface and do not want to write code, Easy Dataset wins. If you need to integrate dataset creation into an automated ML pipeline, a code library is more appropriate.

Maintenance, Upgrades, and License Reality

The repository is active. The last push was 2026-05-01, and releases came out in 2026, with version 1.7.3 in April 2026. That suggests ongoing maintenance. The README mentions a documentation site and tutorial videos, which helps with onboarding. The license is AGPL-3.0, as shown in the badge, but the GitHub API reports NOASSERTION, meaning the license file may not be detected. That is a red flag for legal review. You should open the repository and read the actual LICENSE file. The README also includes a donation link and star prompts, which is common but not relevant to technical evaluation. Upgrade cost is moderate: since it is a desktop app, you download new versions. There is no migration path mentioned for projects or settings across versions. The tool stores your projects locally, presumably, but the README does not specify a data format or export for project configuration. That could be a lock-in risk. If you build a large dataset and the app changes its internal schema, you might have to redo work. The export formats are standard, so your final datasets are portable, but the intermediate project state may not be.

Editorial conclusion

Adopt Easy Dataset if you need a visual, low-code way to turn domain documents into QA pairs or evaluation sets and you can run a desktop app. Skip it if you require a permissive license for redistribution, need to run dataset creation on a server without a GUI, or want to avoid sending document content to third-party LLM APIs. Before committing, verify which document formats your actual corpus uses, confirm your chosen LLM providers are supported, and test the export formats against your downstream fine-tuning or RAG pipeline. The project is actively maintained with recent releases, but its AGPL-3.0 license and desktop-first model are the decisive boundaries.

Official sources

  1. ConardLi/easy-dataset on GitHub
  2. Issues
  3. Project website
  4. README
  5. Releases
Community notes

Community notes