Bạn đang tìm một Gemini Writer – công cụ mã nguồn mở dùng Gemini 3 Flash để tự động viết tiểu thuyết, sách và tập truyện ngắn? Repo này chính là thứ bạn cần: nó giải quyết bài toán tốn thời gian viết lách cho tác giả và content creator, với khả năng suy luận sâu và quản lý ngữ cảnh thông minh.
Thank you for reading this post, don't forget to subscribe!Những điểm chính
- Gemini Writer sử dụng Gemini 3 Flash với 1 triệu token context, tự động lên kế hoạch và viết nội dung dài đến 300 vòng lặp.
- Hỗ trợ đa định dạng: tiểu thuyết, sách kỹ thuật, truyện ngắn; có chế độ real-time streaming và phục hồi sau gián đoạn.
- Cài đặt đơn giản với Python, yêu cầu API key từ Google, phù hợp cho developer và người dùng có kiến thức cơ bản về command line.
Gemini Writer là gì và giải quyết vấn đề gì?
Gemini Writer là một AI agent mã nguồn mở được xây dựng bởi Pietro Schirano, tận dụng mô hình Gemini 3 Flash của Google để tự động hóa quá trình viết văn bản dài. Thay vì bạn phải lên outline từng chương, viết từng câu, công cụ này sẽ lập kế hoạch, viết và quản lý các file markdown một cách độc lập. Vấn đề mà nó giải quyết: tiết kiệm hàng giờ ngồi gõ bàn phím cho những ai cần tạo nội dung dạng sách hoặc truyện nhưng không muốn bỏ hàng tháng trời. Nó đặc biệt hữu ích cho việc prototyping ý tưởng viết lách nhanh.
Bạn có thể xem chi tiết tại repository gốc trên GitHub.
Cơ chế Agentic Loop
Agent hoạt động theo vòng lặp: nhận prompt, suy luận bằng chế độ thinking của Gemini, quyết định gọi công cụ (tạo project, viết file, nén context), xem kết quả và lặp lại tối đa 300 lần. Nhờ đó, nó có thể tự động điều chỉnh và mở rộng nội dung mà không cần can thiệp thủ công.
Những tính năng nổi bật của Gemini Writer là gì?
Gemini Writer được trang bị nhiều tính năng giúp quá trình viết trở nên mượt mà và thông minh hơn. Các tính năng chính bao gồm tự động viết, streaming thời gian thực, quản lý token thông minh và chế độ phục hồi. Dưới đây là danh sách chi tiết:
- Tự động viết (Autonomous Writing): Agent tự lập kế hoạch và thực thi nhiệm vụ viết mà không cần hướng dẫn từng bước.
- Đa định dạng: Có thể tạo tiểu thuyết, sách kỹ thuật, hoặc tập truyện ngắn.
- Streaming thời gian thực: Bạn thấy agent suy nghĩ và viết ngay khi nó đang chạy, không phải chờ đợi.
- Quản lý ngữ cảnh thông minh: Tự động nén context khi gần đạt giới hạn 1 triệu token (ngưỡng 900K).
- Chế độ phục hồi: Lưu context summary sau mỗi 50 vòng lặp, có thể resume nếu bị gián đoạn.
- Giám sát token: Hiển thị real-time số token đã dùng, giúp bạn kiểm soát chi phí API.
- Công cụ hỗ trợ: Agent có thể tạo folder, viết file với ba chế độ (create, append, overwrite) và nén context.
- Suy luận nâng cao: Sử dụng chế độ thinking của Gemini để lập luận tốt hơn.
Cài đặt và sử dụng Gemini Writer như thế nào?
Để chạy Gemini Writer, bạn cần Python và một API key từ Google. Quy trình cài đặt gồm tạo môi trường, cài dependencies và cấu hình file .env. Dưới đây là các bước chi tiết:
Cài đặt
- Cài đặt
uv(nếu chưa có) hoặc dùng pip:curl -LsSf https://astral.sh/uv/install.sh | sh - Clone repo và cd vào thư mục.
- Cài dependencies:
uv pip install -r requirements.txthoặcpip install -r requirements.txt - Copy file
env.examplethành.envvà thêm API key:GEMINI_API_KEY=your-api-key-here - Lấy API key tại Google AI Studio
Sử dụng cơ bản
Chạy với inline prompt: uv run writer.py 'Viết một tiểu thuyết trinh thám 10 chương lấy bối cảnh London thời Victoria'. Hoặc chạy không prompt để vào chế độ tương tác: uv run writer.py.
Chế độ Recovery
Nếu quá trình bị gián đoạn, bạn có thể tiếp tục bằng lệnh: uv run writer.py --recover output/my_project/.context_summary_*.md. Agent sẽ đọc file context summary và tiếp tục từ điểm dừng, rất tiện lợi cho những dự án dài.
Ai nên dùng – ai không nên dùng Gemini Writer?
Gemini Writer phù hợp với tác giả, blogger, content creator muốn tạo nội dung dài nhanh chóng, hoặc developer muốn thử nghiệm khả năng sinh văn bản tự động. Tuy nhiên, nó không dành cho người cần kiểm soát từng câu chữ, hoặc người dùng phổ thông không có kiến thức về Python và command line.
Nếu bạn là tác giả chuyên nghiệp, nên dùng công cụ này như trợ lý phác thảo, sau đó chỉnh sửa lại thủ công.
Câu hỏi thường gặp
Tôi có cần API key không?
Có, bạn bắt buộc phải có Gemini API key từ Google AI Studio. Nếu chưa có, hãy đăng ký tại aistudio.google.com và dán key vào file .env.
Làm sao để phục hồi khi agent bị gián đoạn?
Khi bị gián đoạn (Ctrl+C hoặc lỗi), agent tự động lưu context summary. Bạn chỉ cần chạy lại với flag --recover và đường dẫn đến file .md tương ứng là có thể tiếp tục.
Token limit có ảnh hưởng gì không?
Agent có ngưỡng 900K token trước khi tự nén context. Nếu vượt quá, nó sẽ nén lại để tiếp tục. Bạn nên theo dõi token monitoring để tránh tốn kém không cần thiết.
Kết luận
Gemini Writer là một công cụ mã nguồn mở mạnh mẽ cho những ai muốn tự động hóa việc viết nội dung dài. Với khả năng suy luận sâu, quản lý token thông minh và chế độ phục hồi, nó thực sự hữu ích cho prototyping và sáng tạo nhanh. Nếu bạn là developer hoặc tác giả yêu thích công nghệ, hãy ghé qua repo gốc trên GitHub để trải nghiệm nghen!
