Chuyển đến nội dung

black-forest-labs / flux

FLUX.1

Mã chạy chính thức của dòng mô hình tạo và chỉnh sửa ảnh FLUX.1 từ Black Forest Labs

Repo này chứa mã suy luận tối giản để chạy các mô hình ảnh FLUX.1 của Black Forest Labs trên máy của bạn: tạo ảnh từ chữ, tô vẽ bù vùng thiếu, điều khiển theo đường nét hoặc độ sâu, và chỉnh ảnh bằng lệnh văn bản (Kontext). Có bản miễn phí dùng thương mại và bản chỉ cho phi thương mại, nên cần đọc kỹ giấy phép.

  • 26.060 sao
  • 1.934 fork
  • Python
  • Cập nhật 1 năm trước
  • Apache 2.0 (dùng tự do, kể cả thương mại)
Độ khó
Khó Dành cho người biết lập trình
Dạng
Mô hình AI, Dòng lệnh (CLI)
Chạy trên
Linux, Python
Chi phí
Miễn phí hoàn toàn

Trải nghiệm khi dùng FLUX.1

Đây là mã dành cho người biết dùng Terminal (cửa sổ gõ lệnh). Bạn clone repo, tạo môi trường ảo Python 3.10 rồi cài gói bằng pip. Trọng số mô hình tải từ Hugging Face; một số bản yêu cầu bạn đăng nhập và đồng ý điều khoản trên trang mô hình trước.

Sau khi cài xong, bạn gõ mô tả bằng chữ và nhận lại ảnh. Với FLUX.1 Kontext [dev] bạn đưa ảnh có sẵn và viết lệnh như "thay logo bằng chữ Black Forest Labs" để nó sửa theo yêu cầu. Repo có chế độ chạy lặp (--loop) để thử nhiều câu lệnh liên tiếp.

Nếu chỉ muốn tạo ảnh để làm banner hay minh hoạ mà không muốn gõ lệnh, nhiều công cụ giao diện như ComfyUI hỗ trợ FLUX; repo này thiên về mã tham chiếu chính thức hơn là ứng dụng hoàn chỉnh.

Tính năng nổi bật

Tạo ảnh từ mô tả chữ

FLUX.1 [schnell] và [dev] sinh ảnh từ câu mô tả; [schnell] dùng giấy phép Apache-2.0, [dev] dùng giấy phép riêng phi thương mại.

Chỉnh sửa ảnh bằng câu lệnh

FLUX.1 Kontext [dev] sửa ảnh theo hướng dẫn bằng văn bản, ví dụ đổi chữ trên logo hay đổi chi tiết trong ảnh.

Tô vẽ và mở rộng ảnh

FLUX.1 Fill [dev] cho phép điền lại vùng bị xoá hoặc vẽ thêm ra ngoài khung ảnh.

Điều khiển theo đường nét và độ sâu

Các bản Canny và Depth (kèm bản LoRA) giữ bố cục của ảnh gốc khi tạo ảnh mới.

Tạo biến thể ảnh

FLUX.1 Redux [dev] sinh các biến thể từ một ảnh tham chiếu.

Có API chính thức

Nếu không muốn tự chạy, Black Forest Labs có API và tài liệu tại docs.bfl.ai với cả các bản Pro không công khai trọng số.

Tận dụng FLUX.1 vào việc gì?

Người làm nội dung, chủ shop

Tạo ảnh minh hoạ, banner

Sinh ảnh nền, ảnh minh hoạ bài viết hoặc concept sản phẩm từ mô tả ngắn; kiểm tra kỹ bản quyền và giấy phép của bản mô hình trước khi dùng thương mại.

Nhà thiết kế, người làm video

Chỉnh sửa ảnh bằng lời

Dùng Kontext để đổi chi tiết trong ảnh mà không cần mở phần mềm chỉnh sửa phức tạp.

Người làm thumbnail, dựng hình

Mở rộng khung hình

Dùng Fill để vẽ thêm phần nền ngoài ảnh gốc cho vừa tỉ lệ khung 16:9.

Hoạ sĩ, kiến trúc sư

Giữ bố cục khi đổi phong cách

Dùng Canny hoặc Depth để giữ nguyên bố cục từ phác thảo rồi sinh ảnh hoàn chỉnh.

Lập trình viên AI

Nghiên cứu và nền tảng sản phẩm

Đọc mã tham chiếu để hiểu cách chạy FLUX hoặc tích hợp vào công cụ riêng.

Cần chuẩn bị gì?

  • Python 3.10 và môi trường ảo (venv); README hướng dẫn trên Linux (lệnh source).
  • Cần GPU để chạy thực tế; README không nêu rõ dung lượng VRAM tối thiểu, hãy xem trang mô hình trên Hugging Face.
  • Tài khoản Hugging Face và đồng ý điều khoản cho các mô hình cần xác nhận.
  • Dung lượng ổ cứng lớn để chứa trọng số các mô hình.

Hướng dẫn cài đặt chi tiết

Cài trên Linux

  1. Lấy mã nguồn về thư mục cá nhân.

    Terminal
    cd $HOME && git clone https://github.com/black-forest-labs/flux
    cd $HOME/flux
  2. Tạo môi trường ảo Python 3.10 và kích hoạt nó.

    Terminal
    python3.10 -m venv .venv
    source .venv/bin/activate
  3. Cài repo kèm toàn bộ phụ thuộc.

    Terminal
    pip install -e ".[all]"
  4. Trọng số tải từ Hugging Face; đăng nhập tài khoản và chấp nhận điều khoản trên trang mô hình như FLUX.1-dev hoặc FLUX.1-Kontext-dev trước khi chạy.

Cài trên Windows

  1. README chỉ hướng dẫn lệnh kiểu Linux. Trên Windows, cách ổn thỏa là dùng WSL 2 (Linux chạy trong Windows) rồi làm theo tab Linux, hoặc dùng ComfyUI nếu bạn muốn giao diện đồ hoạ.

  2. Nếu muốn thử bản có giao diện, xem ComfyUI trong Kho Repo và mô hình FLUX ở trang mô hình trên Hugging Face.

    Văn bản
    https://huggingface.co/black-forest-labs

Dùng thử lần đầu

  1. Sau khi cài xong, xem hướng dẫn tạo ảnh từ chữ trong tài liệu docs/text-to-image.md của repo để biết lệnh và tham số hiện hành.

    Văn bản
    https://github.com/black-forest-labs/flux/blob/main/docs/text-to-image.md
  2. Với mô hình chỉnh sửa Kontext, bật chế độ chạy lặp để thử nhiều câu lệnh liên tiếp.

    Terminal
    python -m flux kontext --loop
  3. Thử đưa một ảnh sản phẩm và nhập câu lệnh ngắn, rõ như: đổi nền thành màu trắng sạch, giữ nguyên sản phẩm.

  4. Xem các tính năng khác (Fill, Canny, Depth, Redux) qua các trang docs trong repo và thử từng cái với ảnh nhỏ trước.

Mẹo dùng hay

  • Viết mô tả cụ thể về chủ thể, bối cảnh, ánh sáng sẽ cho ảnh ổn hơn nhiều; mô tả bằng tiếng Anh thường dễ ra kết quả hơn.
  • Bắt đầu với [schnell] nếu muốn dùng thương mại với giấy phép Apache-2.0, còn [dev] chỉ phi thương mại trừ khi mua giấy phép.
  • Lưu lại các prompt tốt cùng thông số để tạo ảnh đồng bộ cho cả chiến dịch.
  • Chạy thử với độ phân giải nhỏ trước khi tăng lên để tiết kiệm thời gian và bộ nhớ.

Lưu ý và hạn chế

  • Hầu hết bản [dev] dùng giấy phép FLUX.1-dev Non-Commercial; dùng thương mại phải mua giấy phép từ Black Forest Labs và mở tính năng theo dõi mức dùng (track_usage) theo hướng dẫn trong README.
  • Có thể bị lạm dụng để tạo ảnh giả mạo người thật hoặc vi phạm bản quyền; không tạo hoặc phát tán ảnh sai sự thật, ảnh xâm phạm quyền riêng tư hay thương hiệu của người khác.
  • Lần cập nhật mã gần nhất của repo là cuối tháng 7 năm 2025 và repo chủ yếu là mã tham chiếu tối giản; không phải ứng dụng có giao diện.

Câu hỏi thường gặp

FLUX miễn phí và dùng thương mại được không?

Tuỳ bản: FLUX.1 [schnell] theo Apache-2.0 nên dùng thương mại được. Các bản [dev] theo giấy phép phi thương mại; muốn dùng thương mại phải đăng ký giấy phép với Black Forest Labs.

Có chạy được trên Windows không?

README chỉ hướng dẫn kiểu Linux. Trên Windows bạn có thể dùng WSL 2 hoặc dùng các giao diện như ComfyUI hỗ trợ FLUX.

Có cần GPU không?

README không hướng dẫn chạy bằng CPU; bạn nên chuẩn bị GPU đủ VRAM, xem yêu cầu cụ thể trên trang từng mô hình.

Tải mã nguồn về máy

Nếu bạn muốn xem hoặc sửa mã nguồn, mở Terminal (trên Windows là PowerShell) và chạy lệnh dưới. Máy cần cài sẵn Git.

Terminal
git clone https://github.com/black-forest-labs/flux.git

Repo tương tự nên xem

Tạo ảnh & video bằng AI147K

ComfyUI

Comfy-Org / ComfyUI

Tạo ảnh, video, âm thanh bằng AI ngay trên máy bằng cách nối các khối (node) thành quy trình

VừaWindowsmacOSLinuxPython
Tạo ảnh & video bằng AI53,9K

Fooocus

lllyasviel / Fooocus

Tạo ảnh AI kiểu Midjourney ngay trên máy bạn, chỉ cần gõ mô tả, ít phải chỉnh thông số

DễWindowsLinuxmacOSPython
Tạo ảnh & video bằng AI165K

Stable Diffusion web UI (AUTOMATIC1111)

AUTOMATIC1111 / stable-diffusion-webui

Giao diện web kinh điển để tạo ảnh bằng Stable Diffusion ngay trên máy tính của bạn

VừaWindowsLinuxmacOSPython

Nội dung được biên soạn bằng tiếng Việt dựa trên tài liệu chính thức của dự án, cập nhật lần cuối 16/11/2026. Lệnh cài có thể thay đổi theo phiên bản mới; nếu có khác biệt, hãy làm theo README trên GitHub.

Cùng chủ đề: Mô hình AI mã nguồn mở

Mô hình AI mã nguồn mở105K

DeepSeek-V3

deepseek-ai / DeepSeek-V3

Mô hình ngôn ngữ mã nguồn mở cỡ 671 tỷ tham số của DeepSeek, dùng qua chat web, API hoặc máy chủ GPU riêng

KhóLinuxPythonWeb
Mô hình AI mã nguồn mở92K

DeepSeek-R1

deepseek-ai / DeepSeek-R1

Mô hình AI "biết suy nghĩ từng bước" mã nguồn mở của DeepSeek, giỏi toán, code và lập luận

KhóWebWindowsmacOSLinux+1
Mô hình AI mã nguồn mở41,6K

BitNet (bitnet.cpp)

microsoft / BitNet

Bộ chạy mô hình AI 1-bit của Microsoft, giúp chạy mô hình ngôn ngữ nhỏ trên CPU thường mà vẫn nhanh

KhóWindowsmacOSLinuxPython
Mô hình AI mã nguồn mở27,7K

Qwen3

QwenLM / Qwen3

Dòng mô hình AI mở của Alibaba Qwen, nhiều cỡ từ 0,6 tỷ đến 235 tỷ tham số, chạy được trên laptop qua Ollama

VừaWindowsmacOSLinuxPython
Mô hình AI mã nguồn mở27,2K

MiniCPM-V và MiniCPM-o

OpenBMB / MiniCPM-V

Mô hình AI nhìn ảnh, nghe tiếng và nói chuyện, nhỏ gọn để chạy trên máy cá nhân và điện thoại

KhóWindowsmacOSLinuxAndroid+2
Mô hình AI mã nguồn mở20,5K

gpt-oss

openai / gpt-oss

Hai mô hình trọng số mở của OpenAI (20B và 120B), bản 20B chạy được trên máy có khoảng 16 GB bộ nhớ

VừaWindowsmacOSLinuxPython

Xem cả 10 repo Mô hình AI mã nguồn mở Về Kho Repo