Cube-Python-1.0 / README.md
NguyenDinhHieu's picture
Update README.md
6bbdfd7 verified
|
raw
history blame
2.59 kB
metadata
license: mit
tags:
  - llm
  - gguf
  - llama
  - langchain
  - ctransformers
  - python
  - code
  - code-assistant
  - local-inference
  - multimodal
library_name: pytorch_lightning
pipeline_tag: text-generation
language:
  - en
  - vi

AI Python — Code Assistant (LangChain + CTransformers)

Demo chạy LLM dạng GGUF bằng ctransformers + langchain để trả lời theo prompt: “chỉ trả lời bằng code Python”.

Demo nhanh

  • Input: một yêu cầu/bài toán Python (text)
  • Output: chỉ code Python (không giải thích)

File chạy chính: app.py
Model mặc định: Cube-Python.gguf

Cài đặt

Tạo môi trường ảo (khuyến nghị) rồi cài dependencies:

pip install -U langchain langchain-community ctransformers

Chạy

Đảm bảo file model Cube-Python.gguf nằm cùng thư mục với app.py, rồi chạy:

python app.py

Cấu hình (trong app.py)

  • MODEL_FILE: tên file GGUF (mặc định Cube-Python.gguf)
  • MODEL_TYPE: loại model cho CTransformers (mặc định llama)
  • GPU_LAYERS:
    • 0 = chạy CPU
    • nếu máy có GPU VRAM đủ, tăng lên (ví dụ 10–20) để nhanh hơn
  • CONTEXT_LENGTH: độ dài ngữ cảnh (mặc định 4096)

Cấu trúc repo

  • app.py: prompt + chain (LangChain) + load model GGUF (CTransformers)
  • Cube-Python.gguf: file model GGUF

Lưu ý khi đẩy lên Hugging Face

  • File .gguf rất lớn: bạn nên dùng Git LFS khi push model lên Hub.
  • Nếu repo này là Model repo: giữ .gguf trong repo và thêm phần “Files and versions”.
  • Nếu repo này là Space: cân nhắc không commit file GGUF trực tiếp (thường vượt giới hạn), thay vào đó tải từ Model repo hoặc từ Release/Storage phù hợp.

Flow đẩy lên Hugging Face (gợi ý)

  1. Tạo repo trên Hugging Face (Model hoặc Space)
  2. Clone repo về máy và copy các file (app.py, README.md, và/hoặc *.gguf)
  3. Bật Git LFS cho GGUF rồi commit/push:
git lfs install
git lfs track "*.gguf"
git add .gitattributes
git add .
git commit -m "Add GGUF python code assistant demo"
git push

Ví dụ prompt

Bạn có thể thay biến question trong app.py bằng bài toán của bạn (tiếng Việt/tiếng Anh đều được).

Credits

  • LangChain
  • CTransformers

Nếu bạn thấy hay

Cho mình xin 1 follow trên Hugging Face và 1 tym (like) cho repo nhé. ❤️