Synthara | The Education Times CLI

An AI-powered command-line tool that generates beautifully formatted, article-style answers using Google's Gemini Model.

Latest Release

Bridging the Quality Gap Hold up your hand with your thumb and index finger about one inch apart. That small gap often marks the difference between a good experience and a truly exceptional one. In our latest release of @synthara-company, we’ve focused on bridging that gap by refining the interface, enhancing article formatting, and optimizing performance to deliver faster, more reliable responses.

Every update is driven by the question, "Can this be even better?" With improvements inspired by your feedback and our dedication to quality, this release ensures that every interaction with Synthara is more polished and intuitive than ever before.

For full details on the changes, please visit our changelog page.

🧠 Overview

Synthara is a sophisticated newspaper-style AI CLI powered by Google's Gemini models. It transforms your queries into elegantly formatted articles directly in your terminal. The responses are presented with professional formatting, including headers, sections, and proper markdown styling.

Why Synthara?

• For Students: Get well-structured, educational content for research and learning
• For Writers: Generate article drafts and creative content with proper formatting
• For Developers: Access AI capabilities with minimal setup in a familiar terminal environment
• For Educators: Create teaching materials and explanations in a readable format

✨ Features

• 📰 Rich Article Formatting: Responses are structured like professional articles with headers, sections, and proper markdown
• 🧠 Multiple AI Models: Choose between Gemini models (flash, pro, preview) for different capabilities and speeds
• 🖼️ Elegant Presentation: Newspaper-style interface with beautiful headers, footers, and typography
• ⚡ Fast & Efficient: Lightweight design with minimal dependencies for quick responses
• 🔐 API Key Management: Securely save your API key for future sessions
• 💻 Terminal Native: Works entirely in your terminal with no browser or GUI required
• 🧪 Developer Friendly: Easy to customize, extend, or integrate into your workflows

---

🚀 Installation

One-Command Setup (Recommended)

Install everything with a single command:

curl -s https://raw.githubusercontent.com/synthara-company/synthara-education-cli/main/setup.sh | bash

This will:

• Create a dedicated installation directory
• Set up a Python virtual environment
• Install all dependencies
• Create a launcher script

After installation, start the application with:

cd ~/synthara-education-cli && ./synthara-education

Manual Installation

If you prefer more control over the installation process:

# Clone the repository
git clone https://github.com/synthara-company/synthara-education-cli.git
cd synthara-education-cli

# Create a virtual environment (recommended)
python3 -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install dependencies
pip install google-generativeai rich

# Run the application
python simple_gemini_cli/gemini_chat.py

# Or create a launcher script for easier access
echo '#!/bin/bash\nsource venv/bin/activate\npython simple_gemini_cli/gemini_chat.py' > synthara-education
chmod +x synthara-education
./synthara-education

API Key

You'll need a Gemini API key from Google AI Studio. The application will prompt you for this key on first run and securely save it for future sessions.

---

🧭 Usage

Getting Started

After installation and launching the application:

1. Enter your Gemini API key when prompted (only needed once)
2. Type your question or topic after the "READER INQUIRY" prompt
3. Receive a beautifully formatted article-style response
4. Continue with more questions or exit when done

Example Queries

What are the ethical implications of artificial intelligence?

Explain quantum computing in simple terms

What are the top 5 advancements in renewable energy?

Commands

• exit or quit: End the session
• key: Update your API key
• model: Switch between different Gemini models:
  • flash: Gemini-1.5-flash (fastest, recommended)
  • pro: Gemini-1.5-pro (more capable)
  • preview: Gemini-2.5-pro-preview (experimental)

Tips for Best Results

• Be specific in your queries for more focused articles
• For complex topics, consider breaking them into multiple questions
• Try different models if you're not satisfied with the response quality
• The flash model is fastest, while pro and preview may provide more detailed responses

---

📦 File Structure

gemini_cli/
├── simple_gemini_cli/
│   ├── gemini_chat.py         # Main CLI entry point
│   └── utils.py               # Utility functions
├── setup-cli.sh               # One-command installer
└── README.md

---

🤝 Contributing

Pull requests are welcome! Ideas, fixes, or feature suggestions—go ahead and contribute.

• Fork the repo
• Create a feature branch
• Submit your PR

Check out contributing guidelines (coming soon).

---

💖 Credits

Made with 💡 and 🚀 by Niladri Das

---

📜 License

MIT — See license file for more information.

---

📣 Spread the Word

If you liked the project, please consider sharing it! It helps a ton 💙