Book-translator-v1

📚 Book Translator v1 – by Malemsana

Ever wanted to read Sherlock Holmes or any classic book…
but the language was so ancient it hurt your brain? 😩📖

This tool changes that.
Welcome to the Book Translator v1, a powerful tool that rewrites and translates books into simpler, modern, or native-language versions — all powered by an LLM like Gemini.

---

✨ Features

• 🔁 Translate entire .epub or .txt books
• 🧠 Convert Victorian/Old English to simple, readable English
• 🌍 Works with multiple languages
• ✍️ Modify writing style as well as language (e.g., casual tone, academic tone)
• 📦 Output is saved as a clean .epub – ready to read on your favorite e-reader

---

🧰 Requirements

You can run this in Google Colab (recommended) or locally with Python 3.

pip install ebooklib langdetect tqdm
# plus either OpenAI or Gemini API packages:
pip install openai
# or for Gemini:
pip install google-generativeai

---

🚀 How to Use (Colab Recommended)

🟢 Step-by-step (Colab):

1. Open book_translator_colab.ipynb
2. Upload your .epub or .pdffile when prompted
3. Enter:
   • Your API key (Gemini or OpenAI)
   • Your source style or language (e.g., “Victorian English”)
   • Your target style or language (e.g., “Simple English” or “Hindi”)
4. Run all the cells — the notebook:
   • Breaks your book into chunks
   • Sends each one to the LLM
   • Reassembles them into a translated .epub
5. Download and enjoy your upgraded book 🤓📱

---

🧠 Example Prompt

We send prompts like this to the model:

“Rewrite the following text into simple, modern English.
Make sure it’s easy to understand, while keeping the original meaning.
Avoid old-fashioned vocabulary.”

This creates output that’s smooth and readable — perfect for younger readers or second-language learners!

---

🧪 Example Result

Original:

“To James Mortimer, M.R.C.S., from his friends of the C.C.H.,” was written on it...

Translated:

It said, “To James Mortimer, M.R.C.S., from his friends at the C.C.H.”...

---

🔮 Future Upgrades

• 🎨 Tone options like “child-friendly”, “detective report”, or “chat-style”
• 📖 Upload multiple books
• 🗣️ Convert to audio with text-to-speech
• 🌐 Web UI version in the works

---

👑 Author

Created with love by Malemsana 🧪
This project was born from a desire to actually finish reading Sherlock Holmes without needing a dictionary.

Check out my profile: huggingface.co/Malemsana

---

⚖️ License

MIT – use it, remix it, improve it. Give old books new life.

---

⭐ If this tool helps you read, learn, or enjoy more books — give it a star!