Metadata-Version: 2.4
Name: transmeet
Version: 0.0.3
Summary: LLM-powered meeting transcription and summarization tool.
Home-page: https://github.com/codeperfectplus/transmeet
Author: Deepak Raj
Author-email: deepak008@live.com
License: MIT
Project-URL: Source, https://github.com/codeperfectplus/transmeet
Project-URL: Issues, https://github.com/codeperfectplus/transmeet/issues
Project-URL: Documentation, https://transmeet.readthedocs.io/en/latest/
Keywords: transcription,meeting summarization,audio processing,LLM,Groq,Google Speech,CLI,automation
Classifier: Development Status :: 3 - Alpha
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Multimedia :: Sound/Audio :: Analysis
Requires-Python: >=3.7
Description-Content-Type: text/markdown
Requires-Dist: pydub
Requires-Dist: groq
Requires-Dist: SpeechRecognition
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: license
Dynamic: project-url
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# 🎙️ TransMeet — AI-Powered Meeting Summarizer

> **Turn your meeting recordings into clear, structured minutes using LLMs like Groq Whisper and Google Speech Recognition.**

---

## 🚀 Features

* ✅ **Audio Transcription** — Automatically convert `.wav` or `.mp3` files into text
* 🧠 **LLM-Powered Summarization** — Generate concise and structured meeting minutes
* 🔍 **Groq & Google Support** — Choose between Groq Whisper models or Google Speech API
* 🪓 **Automatic Chunking** — Splits large files intelligently for smoother transcription
* 🧾 **CLI & Python API** — Use it from the terminal or integrate in your Python workflows
* 📁 **Clean Output** — Saves transcripts and summaries neatly in your desired folder

---

## 📦 Installation

```bash
pip install transmeet
```

---

## 🔐 Setup

Set your **GROQ API Key** as an environment variable:

```bash
export GROQ_API_KEY=your_groq_api_key
```

To make this permanent, add it to your shell config (e.g., `~/.bashrc` or `~/.zshrc`):

```bash
echo 'export GROQ_API_KEY=your_groq_api_key' >> ~/.bashrc
```

---

## 🧑‍💻 How to Use

### ✅ Option 1: Import as a Python Module

```python
from transmeet import generate_meeting_transcript_and_minutes

audio_path = "/path/to/your/audio.wav"
output_path = "/path/to/output/folder"

generate_meeting_transcript_and_minutes(audio_path, output_path)
```

This will save two files in your output directory:

* `transcription_<timestamp>.txt`
* `meeting_minutes_<timestamp>.md`

---

### 🔧 Option 2: Use the CLI

#### Basic Command

```bash
transmeet -a /path/to/audio.wav -o output/
```

---

## 🗂️ Output Structure

```
output/
├── transcriptions/
│   └── transcription_20250510_213038.txt
├── meeting_minutes/
│   └── meeting_minutes_20250510_213041.md
```

---

## 🧪 Supported Formats

* `.wav`
* `.mp3`

---

## 🛠️ Configuration

You can also customize transcription behavior using a `config.conf` file (optional). See examples in the repo.

---

## 🤖 LLM Models

* **Groq Whisper** (e.g. `whisper-large`)
* **Google Speech Recognition** (fallback if `--use-groq` not set)

---

## 📋 Roadmap

* [ ] Add support for multi-language meetings
* [ ] Speaker diarization support
* [ ] Upload directly to Notion or Google Docs
* [ ] Slack/Discord bots

---

## 🧑‍🎓 Author

**Deepak Raj**
👨‍💻 [GitHub](https://github.com/coderperfectplus) • 🌐 [LinkedIN](https://www.linkedin.com/in/deepak-raj-35887386/s)

---

## 🤝 Contributing

Pull requests are welcome! If you find a bug or want a feature, open an issue or submit a PR.

---

## ⚖️ License

[MIT License](LICENSE)
