cleverlabs-llm-suite

# 🧠 CleverLabs LLM Suite

A curated collection of **LLM-powered applications, AI agents, and GenAI experiments** built to explore real-world AI use cases.

The goal of this repository is simple:

> **Build practical AI tools quickly and learn by shipping real applications.**

Inspired by popular open-source collections like awesome LLM application repositories, this suite contains **small, focused AI projects** demonstrating how Large Language Models can power useful products.

---

# 🚀 What This Repository Is

**CleverLabs LLM Suite** is a playground for experimenting with:

- 🤖 AI agents  
- 📚 Knowledge generators  
- 🧠 Educational tools  
- ⚡ Productivity assistants  
- 🔎 AI-powered research tools  

Each project is designed to be:

- Simple  
- Modular  
- Easy to run  
- Easy to extend  

---

# 📦 Repository Structure

```
cleverlabs-llm-suite
│
├── ai_history_generator_agent
│   ├── app.py
│   ├── requirements.txt
│   └── README.md
│
├── upcoming_apps
│   └── future AI experiments
│
└── README.md
```

Each folder represents a **self-contained AI application**.

---

# ✨ Current Applications

## 🏛 AI History Generator Agent

Generate engaging **historical narratives and explanations** using LLMs.

### Features

- Generate historical summaries  
- Explain civilizations and events  
- Learn about historical figures  
- Educational storytelling  

### Example Prompts

```
Explain the fall of the Roman Empire
Tell me about the Indus Valley Civilization
Who was Cleopatra?
Explain the causes of World War 1
```

---

## 📚 BookGPT

An **AI-powered book recommendation app** that suggests books based on a user-provided storyline, mood, theme, and narrative tone.

### Features

- Recommend books dynamically based on story ideas  
- Tailor recommendations with Mood, Theme, and Tone  
- Optional Storytelling Mode generates a short story snippet  
- Structured output including:
  - Book Name & Author  
  - Overview  
  - Why You’ll Like It  
  - Reading Level & Estimated Time  
  - Fun Facts  
- Works with **local LLaMA models** or a fallback mock for testing  

### Example Prompts

A young detective solving a mysterious case in a small town
A journey of self-discovery and personal growth
A fast-paced thriller about corporate espionage
---

# 🛠 Tech Stack

Projects in this repository may use:

- Python  
- Streamlit  
- LLM APIs  
- Local models (GPT4All / Ollama)  
- LangChain  
- REST APIs  

---

# ⚡ Quick Start

## 1️⃣ Clone the repository

```bash
git clone https://github.com/techravish/cleverlabs-llm-suite.git
cd cleverlabs-llm-suite
```

---

## 2️⃣ Create virtual environment

```bash
python -m venv .venv
```

Activate:

**Mac / Linux**

```bash
source .venv/bin/activate
```

**Windows**

```bash
.venv\Scripts\activate
```

---

## 3️⃣ Install dependencies

```bash
pip install -r requirements.txt
```

---

## 4️⃣ Run the app

Example:

```bash
cd ai_history_generator_agent
streamlit run {app_name.py}
```

The app will open in your browser.

---

# 🤝 Contributing

Contributions are welcome.

### Steps

1. Fork the repository  
2. Create a new feature branch

```bash
git checkout -b new-ai-project
```

3. Add your AI experiment  
4. Submit a Pull Request  

---

# 📜 License

MIT License

---

# 👨‍💻 Author

**Ravish Rawat**

GitHub  
https://github.com/techravish

---

⭐ If you like this project, **please star the repository.**