Installation

Getting started with Synthara Education Times CLI is quick and easy. Choose from one of the installation methods below.

One-Command Setup (Recommended)

The easiest way to install Synthara Education Times CLI is using our one-command setup script:

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

This script will:

  • Clone the repository to ~/synthara-cli
  • Create a virtual environment
  • Install all required dependencies
  • Create a launcher script for easy access

After installation, you can start the application by running:

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

Manual Installation

If you prefer to install manually, follow these steps:

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

# Create a virtual environment
python -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
source venv/bin/activate
python 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.

Your API key is stored locally on your machine and is never shared with external services.

Usage

Learn how to use Synthara Education Times CLI effectively.

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
Synthara CLI
READER INQUIRY: Explain quantum computing in simple terms

Quantum Computing: The Next Frontier in Computing Power

Imagine if your computer could try all possible solutions to a problem at once instead of checking them one by one...

Commands

Synthara Education Times CLI supports several 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)

Example Queries

Here are some example queries to try with Synthara:

What are the ethical implications of artificial intelligence?

Explain quantum computing in simple terms

What are the top 5 advancements in renewable energy?

How does machine learning differ from traditional programming?

What are the most effective study techniques according to cognitive science?

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
  • Use clear, well-structured questions to get the best results

Configuration

Synthara Education Times CLI stores configuration in a simple JSON file located at ~/.synthara/config.json. This file contains your API key and preferred model settings.

You can manually edit this file if needed, but it's recommended to use the built-in commands (key, model) to update your configuration.

config.json
{
  "api_key": "YOUR_API_KEY",
  "model": "flash"
}

Troubleshooting

If you're experiencing issues with your API key:

  1. Verify that your API key is correct and active in the Google AI Studio
  2. Try updating your key using the key command
  3. Check if you've reached your API usage limits
  4. If all else fails, you can manually delete the config file at ~/.synthara/config.json and restart the application

If you encounter issues during installation:

  1. Make sure you have Python 3.7 or higher installed
  2. Check that you have pip installed and updated
  3. Try installing the dependencies manually: pip install google-generativeai rich
  4. If you're using a virtual environment, ensure it's activated before installing dependencies
  5. On some systems, you might need to use python3 instead of python

If you're not satisfied with the quality of responses:

  1. Try switching to a more capable model using the model command (e.g., model pro)
  2. Make your queries more specific and detailed
  3. Break complex topics into multiple, focused questions
  4. Remember that AI models have limitations and may not always provide perfect responses

Frequently Asked Questions

Yes, your API key is stored locally on your machine in ~/.synthara/config.json and is never shared with external services. The application only uses your key to make requests to the Google Gemini API.

We recommend starting with the flash model (Gemini-1.5-flash) as it provides a good balance of speed and quality. If you need more detailed or nuanced responses, try the pro model (Gemini-1.5-pro). The preview model (Gemini-2.5-pro-preview) is experimental and may provide the most advanced capabilities but could be slower.

No, Synthara Education Times CLI requires an internet connection to communicate with the Google Gemini API. All processing happens on Google's servers, not locally on your machine.

Usage limits depend on your Google Gemini API plan. The free tier has certain limits on the number of requests you can make per minute and per day. Check the Google AI pricing page for the most up-to-date information on usage limits.

We welcome contributions! You can contribute by:

  • Reporting bugs or suggesting features on our GitHub issues page
  • Submitting pull requests with code improvements or new features
  • Improving documentation
  • Sharing the project with others who might find it useful

Ready to get started?

Install Synthara | The Education Times CLI today!