Chinese Novel Translator API

Tiếng Việt | English | 中文

API sử dụng Microsoft Agent Framework và DeepSeek để dịch tiểu thuyết Trung Quốc sang tiếng Việt.

Cấu trúc project

app/
|-- ai/             Workflow phân tích truyện bằng DeepSeek
|-- core/           Cấu hình, database và pagination
|-- dtos/           Request và response models
|-- ebook/          Đọc và tách nội dung TXT/EPUB
|-- endpoints/      FastAPI endpoints
|-- entities/       SQLAlchemy entities
|-- repositories/   Truy cập database
|-- services/       Business logic
`-- main.py         FastAPI application

Cài đặt

Yêu cầu:

• Python 3.14 trở lên
• uv
• DeepSeek API key

Cài đặt dependency:

uv sync

Tạo file .env từ file mẫu:

Copy-Item .env.example .env

Cấu hình .env:

DEEPSEEK_API_KEY=sk-xxxxxxxxxxxxxxxx
DATABASE_URL=sqlite:///./app.db

DATABASE_URL không bắt buộc. Nếu không khai báo, project sử dụng SQLite tại app.db.

Chạy project

uv run fastapi dev

API mặc định chạy tại http://127.0.0.1:8000.

Tài liệu API:

Swagger UI: http://127.0.0.1:8000/docs
ReDoc:      http://127.0.0.1:8000/redoc
OpenAPI:    http://127.0.0.1:8000/openapi.json

Database và các bảng được tạo tự động khi ứng dụng khởi động.

Giấy phép

Dự án này được phát hành theo Apache License 2.0.