---
title: "LlamaFactory vs instructor-embedding"
type: "comparison"
canonical_url: "https://www.graphcanon.com/compare/hiyouga-llamafactory-vs-xlang-ai-instructor-embedding"
tools: ["hiyouga-llamafactory", "xlang-ai-instructor-embedding"]
---

# LlamaFactory vs instructor-embedding

*GraphCanon updated Jul 11, 2026*

## Verdict

Pick LlamaFactory when tags unique to LlamaFactory: gemma, fine-tuning, deepseek, ai; pick instructor-embedding when tags unique to instructor-embedding: text-classification, embeddings, text-embedding, prompt-retrieval.

[LlamaFactory](https://llamafactory.readthedocs.io) reports 73k GitHub stars, 8.9k forks, and 1.1k open issues, last pushed Jul 10, 2026. [instructor-embedding](https://github.com/xlang-ai/instructor-embedding) has 2.0k stars, 156 forks, and 37 open issues, last pushed Jan 15, 2025. Figures are from public GitHub metadata via [LlamaFactory's repository](https://github.com/hiyouga/LlamaFactory) and [instructor-embedding's repository](https://github.com/xlang-ai/instructor-embedding).

| | [LlamaFactory](/tools/hiyouga-llamafactory.md) | [instructor-embedding](/tools/xlang-ai-instructor-embedding.md) |
| --- | --- | --- |
| Tagline | Unified Efficient Fine-Tuning of 100+ LLMs & VLMs | [ACL 2023] One Embedder, Any Task: Instruction-Finetuned Text Embeddings |
| Stars | 73,157 | 2,024 |
| Forks | 8,937 | 156 |
| Open issues | 1,067 | 37 |
| Language | Python | Python |
| Adopt for | LlamaFactory is a sophisticated tool for fine-tuning numerous large language models and visual language models efficiently using various methods such as LoRA, QLoRA, RLHF, and quantization. | - |
| Persona | - | - |
| Runtime | - | - |
| License | Apache-2.0 | Apache-2.0 |
| Categories | LLM Frameworks, Model Training | LLM Frameworks, Model Training, Vector Databases |

## Trust and health

_Sourced signals - not a safety guarantee. No winner column._

| | [LlamaFactory](/tools/hiyouga-llamafactory.md) | [instructor-embedding](/tools/xlang-ai-instructor-embedding.md) |
| --- | --- | --- |
| Maintenance | Very active (96%) | Dormant (18%) |
| Days since push | 0d | 541d |
| Open issues (now) | 1.1k | 37 |
| Owner type | User | Organization |
| Full report | [trust report](/tools/hiyouga-llamafactory/trust.md) | [trust report](/tools/xlang-ai-instructor-embedding/trust.md) |

## Decision facts: LlamaFactory

- **Adopt for:** LlamaFactory is a sophisticated tool for fine-tuning numerous large language models and visual language models efficiently using various methods such as LoRA, QLoRA, RLHF, and quantization.

## Choose when

### Choose LlamaFactory if…

- Tags unique to LlamaFactory: gemma, fine-tuning, deepseek, ai.
- When you need to fine-tune over 100 different LLMs or VLMs with efficient methods like LoRA or QLoRA.
- More GitHub stars (73k vs 2.0k) - visibility, not fit.

### Choose instructor-embedding if…

- Tags unique to instructor-embedding: text-classification, embeddings, text-embedding, prompt-retrieval.
- Also covers Vector Databases.
- Leaner open-issue backlog (37).

## When NOT to use LlamaFactory

- When you are looking to fine-tune less popular or niche models that are not supported within the 100+ models covered by LlamaFactory.
- If your project specifically requires custom fine-tuning methods not available in this repository, such as certain versions of PEFT (Parameter Efficient Fine-Tuning) techniques excluding LoRA and QLoa

## When NOT to use instructor-embedding

- Last GitHub push was 542 days ago (dormant maintenance, Jan 15, 2025). Validate activity before betting a new project on instructor-embedding.
- LLM Frameworks: Avoid a framework for a single prompt-and-retrieve call; the abstraction can cost more than it saves.
- Model Training: Try prompting and RAG first; fine-tuning is the answer to style/format, not missing knowledge.
- Vector Databases: Don't reach for a dedicated vector DB under ~100k vectors; pgvector on your existing Postgres is simpler to operate.

## Common questions

### What is the difference between LlamaFactory and instructor-embedding?

LlamaFactory: Unified Efficient Fine-Tuning of 100+ LLMs & VLMs. instructor-embedding: [ACL 2023] One Embedder, Any Task: Instruction-Finetuned Text Embeddings. See the comparison table for live GitHub stats and shared categories.

### When should I choose LlamaFactory over instructor-embedding?

Choose LlamaFactory over instructor-embedding when Tags unique to LlamaFactory: gemma, fine-tuning, deepseek, ai; When you need to fine-tune over 100 different LLMs or VLMs with efficient methods like LoRA or QLoRA; More GitHub stars (73k vs 2.0k) - visibility, not fit.

### When should I choose instructor-embedding over LlamaFactory?

Choose instructor-embedding over LlamaFactory when Tags unique to instructor-embedding: text-classification, embeddings, text-embedding, prompt-retrieval; Also covers Vector Databases; Leaner open-issue backlog (37).

### When should I avoid LlamaFactory?

When you are looking to fine-tune less popular or niche models that are not supported within the 100+ models covered by LlamaFactory. If your project specifically requires custom fine-tuning methods not available in this repository, such as certain versions of PEFT (Parameter Efficient Fine-Tuning) techniques excluding LoRA and QLoa

### When should I avoid instructor-embedding?

Last GitHub push was 542 days ago (dormant maintenance, Jan 15, 2025). Validate activity before betting a new project on instructor-embedding. LLM Frameworks: Avoid a framework for a single prompt-and-retrieve call; the abstraction can cost more than it saves. Model Training: Try prompting and RAG first; fine-tuning is the answer to style/format, not missing knowledge. Vector Databases: Don't reach for a dedicated vector DB under ~100k vectors; pgvector on your existing Postgres is simpler to operate.

### Is LlamaFactory or instructor-embedding more popular on GitHub?

LlamaFactory has more GitHub stars (73,157 vs 2,024). Stars measure visibility, not whether either tool fits your constraints.

### Are LlamaFactory and instructor-embedding open source?

Yes - both are open-source projects on GitHub (LlamaFactory: Apache-2.0, instructor-embedding: Apache-2.0).

### Where can I find alternatives to LlamaFactory or instructor-embedding?

GraphCanon lists graph-backed alternatives at [LlamaFactory alternatives](/tools/hiyouga-llamafactory/alternatives) and [instructor-embedding alternatives](/tools/xlang-ai-instructor-embedding/alternatives) ([LlamaFactory markdown twin](/tools/hiyouga-llamafactory/alternatives.md), [instructor-embedding markdown twin](/tools/xlang-ai-instructor-embedding/alternatives.md)), ranked by typed relationship edges rather than popularity votes.

### Is there a machine-readable version of this comparison?

Yes. The markdown twin at [this comparison](/compare/hiyouga-llamafactory-vs-xlang-ai-instructor-embedding.md) mirrors this page for agents and LLM crawlers, with the same stats table and FAQ answers.

### Which is better maintained, LlamaFactory or instructor-embedding?

LlamaFactory: Very active. instructor-embedding: Dormant. Compare maintenance labels, days since push, and release cadence in the trust section below - stars alone do not measure maintenance.

### Where are the full trust reports for LlamaFactory and instructor-embedding?

GraphCanon publishes per-repo trust reports with dated maintenance, provenance, and scan summaries: [LlamaFactory trust report](/tools/hiyouga-llamafactory/trust); [instructor-embedding trust report](/tools/xlang-ai-instructor-embedding/trust).

---

**Machine-readable endpoints**

- JSON: [`/api/graphcanon/graph?tool=hiyouga-llamafactory`](/api/graphcanon/graph?tool=hiyouga-llamafactory)
- LLM index: [/llms.txt](/llms.txt)
- Full corpus: [/llms-full.txt](/llms-full.txt)

_GraphCanon - The knowledge graph for AI development. https://www.graphcanon.com/_
