{"id":28085748,"url":"https://github.com/codeperfectplus/transmeet","last_synced_at":"2026-03-10T20:36:44.744Z","repository":{"id":292612926,"uuid":"950024851","full_name":"codeperfectplus/transmeet","owner":"codeperfectplus","description":"LLM based meeting summarization tool","archived":false,"fork":false,"pushed_at":"2025-06-14T04:12:58.000Z","size":134,"stargazers_count":0,"open_issues_count":1,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-02T09:45:56.851Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/codeperfectplus.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-03-17T14:10:35.000Z","updated_at":"2025-06-14T04:13:01.000Z","dependencies_parsed_at":"2025-06-13T16:48:42.836Z","dependency_job_id":"4f63b3c7-07fd-4a8f-a965-892f5ac2b6df","html_url":"https://github.com/codeperfectplus/transmeet","commit_stats":null,"previous_names":["codeperfectplus/transmeet"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/codeperfectplus/transmeet","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codeperfectplus%2Ftransmeet","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codeperfectplus%2Ftransmeet/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codeperfectplus%2Ftransmeet/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codeperfectplus%2Ftransmeet/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/codeperfectplus","download_url":"https://codeload.github.com/codeperfectplus/transmeet/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codeperfectplus%2Ftransmeet/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30352938,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-10T15:55:29.454Z","status":"ssl_error","status_checked_at":"2026-03-10T15:54:58.440Z","response_time":106,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-05-13T10:41:57.924Z","updated_at":"2026-03-10T20:36:44.734Z","avatar_url":"https://github.com/codeperfectplus.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🎙️ TransMeet — AI-Powered Meeting Summarizer\n\n\u003e **Turn your meeting recordings into clear, structured minutes using LLMs like Groq Whisper and Google Speech Recognition.**\n\n---\n\n## 🚀 Features\n\n* ✅ **Audio Transcription** — Automatically convert `.wav` or `.mp3` files into text\n* 🧠 **LLM-Powered Summarization** — Generate concise and structured meeting minutes\n* 🔍 **Groq \u0026 Google Support** — Choose between Groq Whisper models or Google Speech API\n* 🪓 **Automatic Chunking** — Splits large files intelligently for smoother transcription\n* ⚙️ **Fully Customizable** — Pick your preferred transcription and summarization models\n* 🧾 **CLI \u0026 Python API** — Use it from the terminal or integrate in your Python workflows\n* 📁 **Clean Output** — Saves transcripts and summaries neatly in your desired folder\n\n---\n\n## 📦 Installation\n\n```bash\npip install transmeet\n```\n\n## Dependencies\n\n```bash\nsudo apt-get update \u0026\u0026 sudo apt-get install -y ffmpeg gcc \u0026\u0026 sudo apt-get clean \u0026\u0026 sudo rm -rf /var/lib/apt/lists/*\n```\n\n## 🔐 Setup\n\nSet your **GROQ API Key**/**OPENAI API Key** in your environment variables.\n\n```bash\nexport GROQ_API_KEY=your_groq_api_key\n```\n\nTo make this permanent:\n\n```bash\necho 'export GROQ_API_KEY=your_groq_api_key' \u003e\u003e ~/.bashrc\n```\n\n\u003e If using OPENAI, set the `OPENAI_API_KEY` similarly.\n\u003e For Google Speech, no API key is needed; it uses the default model.\n\n---\n\n## 🧑‍💻 How to Use\n\n### ✅ Option 1: Import as a Python Module\n\n```python\nfrom transmeet import generate_meeting_transcript_and_minutes\n\ngenerate_meeting_transcript_and_minutes(\n    meeting_audio_file=\"/path/to/audio.wav\",\n    output_dir=\"complete_path_to_output_dir/\",\n    transcription_client=\"groq\",  # or \"openai\"\n    transcription_model=\"whisper-large-v3-turbo\", # change as per your need\n    llm_client=\"groq\",  # or \"openai\"\n    llm_model=\"llama-3.3-70b-versatile\", # change as per your need\n)\n```\n\nThis will save two files in your output directory:\n\n* `transcription_\u003ctimestamp\u003e.txt`\n* `meeting_minutes_\u003ctimestamp\u003e.md`\n\n---\n\n### 🔧 Option 2: Use the CLI\n\n#### 🔹 Basic Usage (Default: GROQ)\n\n```bash\ntransmeet -i /path/to/audio.wav -o output/\n```\n\n#### 🔸 Advanced Usage\n\n```bash\ntransmeet \\\n  -i /path/to/audio.wav \\\n  -o output/ \\\n  --transcription-client groq \\\n  --transcription-model whisper-large-v3-turbo \\\n  --llm-client groq \\\n  --llm-model llama-3.3-70b-versatile \\\n```\n\n---\n\n## 🗂️ Output Structure\n\n```\noutput/\n├── transcriptions/\n│   └── transcription_20250510_213038.txt\n├── meeting_minutes/\n│   └── meeting_minutes_20250510_213041.md\n```\n\n---\n\n## 🧪 Supported Formats\n\n* `.wav`\n* `.mp3`\n\n---\n\n## ⚙️ CLI Options\n\n| Argument                 | Description                                   |\n| ------------------------ | --------------------------------------------- |\n| `-i`, `--audio-path`     | Path to the input audio file                  |\n| `-o`, `--output-dir`     | Output directory (default: `output/`)         |\n| `--transcription-client` | `groq` or `google` (default: `groq`)          |\n| `--transcription-model`  | e.g., `whisper-large-v3-turbo`                |\n| `--llm-client`           | `groq` or `openai` (default: `groq`)          |\n| `--llm-model`            | e.g., `llama-3.3-70b-versatile`               |\n\n---\n\n## 🤖 LLM Models\n\n* **Groq Whisper**: `whisper-large`, `whisper-large-v3-turbo`, etc.\n* **Google Speech**: Model defaults to their API standard\n* **LLMs for minutes**: `llama-3`, `mixtral`, `gpt-4`, etc. (Groq/OpenAI)\n\n---\n\n## 📋 Roadmap\n\n* [ ] Add support for multi-language meetings\n* [ ] Speaker diarization support\n* [ ] Upload directly to Notion or Google Docs\n* [ ] Slack/Discord bots\n\n---\n\n## 🧑‍🎓 Author\n\n**Deepak Raj**\n👨‍💻 [GitHub](https://github.com/coderperfectplus) • 🌐 [LinkedIN](https://www.linkedin.com/in/deepak-raj-35887386/s)\n\n---\n\n## 🤝 Contributing\n\nPull requests are welcome! Found a bug or need a feature? Open an issue or submit a PR.\n\n---\n\n## ⚖️ License\n\n[MIT License](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodeperfectplus%2Ftransmeet","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcodeperfectplus%2Ftransmeet","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodeperfectplus%2Ftransmeet/lists"}