Falcon H1 1.5B Instruct

🚀 变形金刚（transformers）库

本项目提供了基于transformers库使用Falcon-H1系列模型的方法，支持多种推理方式，在多种任务上表现出色，能为自然语言处理相关工作提供强大助力。

🚀 快速开始

目前，要使用此模型，你可以依赖Hugging Face的transformers、vLLM或我们定制的llama.cpp库的分支。

推理

确保安装最新版本的transformers或vLLM，必要时从源代码安装这些包：

pip install git+https://github.com/huggingface/transformers.git

更多关于从源代码构建vLLM的详细信息，请参考官方vLLM文档。

🤗 transformers

参考以下代码片段，使用🤗 transformers运行H1模型：

import torch
from transformers import AutoModelForCausalLM, AutoTokenizer

model_id = "tiiuae/Falcon-H1-1B-Base"

model = AutoModelForCausalLM.from_pretrained(
  model_id,
  torch_dtype=torch.bfloat16,
  device_map="auto"
)

# Perform text generation

vLLM

对于vLLM，只需执行以下命令启动服务器：

# pip install vllm
vllm serve tiiuae/Falcon-H1-1B-Instruct --tensor-parallel-size 2 --data-parallel-size 1

llama.cpp

我们正在努力将我们的架构直接集成到llama.cpp库中，在此期间，你可以安装我们的库分支并直接使用：https://github.com/tiiuae/llama.cpp-Falcon-H1，安装指南与llama.cpp相同。

✨ 主要特性

• 模型类型：因果解码器
• 架构：混合Transformer + Mamba架构
• 支持语言：英语、多语言
• 许可证：Falcon-LLM许可证

📦 安装指南

安装transformers

pip install git+https://github.com/huggingface/transformers.git

安装vLLM

pip install vllm

安装llama.cpp分支

参考https://github.com/tiiuae/llama.cpp-Falcon-H1的安装指南。

💻 使用示例

基础用法

import torch
from transformers import AutoModelForCausalLM, AutoTokenizer

model_id = "tiiuae/Falcon-H1-1B-Base"

model = AutoModelForCausalLM.from_pretrained(
  model_id,
  torch_dtype=torch.bfloat16,
  device_map="auto"
)

# Perform text generation

高级用法

# vLLM启动服务器
vllm serve tiiuae/Falcon-H1-1B-Instruct --tensor-parallel-size 2 --data-parallel-size 1

📚 详细文档

模型详情

• 开发者：https://www.tii.ae
• 模型类型：因果解码器
• 架构：混合Transformer + Mamba架构
• 支持语言：英语、多语言
• 许可证：Falcon-LLM许可证

训练详情

有关此模型训练协议的更多详细信息，请参考Falcon-H1技术博客文章。

评估

Falcon-H1系列在各种任务上表现出色，包括推理任务。

你可以在我们的发布博客文章中查看更详细的基准测试。

有用链接

• 查看我们的发布博客文章。
• 如果你有任何问题或想与我们的研究人员和开发人员交流，请随时加入我们的Discord服务器。

🔧 技术细节

有关此模型训练协议的更多详细信息，请参考Falcon-H1技术博客文章。

📄 许可证

本项目使用Falcon-LLM许可证，详情请见https://falconllm.tii.ae/falcon-terms-and-conditions.html。

引用

如果Falcon-H1系列模型对你的工作有帮助，请引用：

@misc{tiifalconh1,
    title = {Falcon-H1: A Family of Hybrid-Head Language Models Redefining Efficiency and Performance},
    url = {https://falcon-lm.github.io/blog/falcon-h1},
    author = {Falcon-LLM Team},
    month = {May},
    year = {2025}
}