Metadata-Version: 2.1
Name: mtabe
Version: 1.4.0
Summary: An AI-powered CLI for adding notes and generating flashcards, tests, and chat summaries.
Home-page: https://github.com/Henryle-hd/mtabe
Author: Henrylee
Author-email: henrydionizi@gmail.com
Keywords: cli ai notes flashcards
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: annotated-types>=0.7.0
Requires-Dist: anyio>=4.9.0
Requires-Dist: beautifulsoup4>=4.13.4
Requires-Dist: bs4>=0.0.2
Requires-Dist: certifi>=2025.4.26
Requires-Dist: charset-normalizer>=3.4.1
Requires-Dist: click>=8.1.8
Requires-Dist: colorama>=0.4.6
Requires-Dist: comtypes>=1.4.10
Requires-Dist: distro>=1.9.0
Requires-Dist: et_xmlfile>=2.0.0
Requires-Dist: groq>=0.23.1
Requires-Dist: h11>=0.16.0
Requires-Dist: httpcore>=1.0.9
Requires-Dist: httpx>=0.28.1
Requires-Dist: idna>=3.10
Requires-Dist: lxml>=5.4.0
Requires-Dist: markdown-it-py>=3.0.0
Requires-Dist: mdurl>=0.1.2
Requires-Dist: numpy>=2.2.5
Requires-Dist: openpyxl>=3.1.5
Requires-Dist: pandas>=2.2.3
Requires-Dist: pillow>=11.2.1
Requires-Dist: pydantic>=2.11.4
Requires-Dist: pydantic_core>=2.33.2
Requires-Dist: pyfiglet>=1.0.2
Requires-Dist: Pygments>=2.19.1
Requires-Dist: PyPDF2>=3.0.1
Requires-Dist: pypiwin32>=223
Requires-Dist: python-dateutil>=2.9.0.post0
Requires-Dist: python-docx>=1.1.2
Requires-Dist: python-dotenv>=1.1.0
Requires-Dist: python-pptx>=1.0.2
Requires-Dist: pyttsx3>=2.98
Requires-Dist: pytz>=2025.2
Requires-Dist: pywin32>=310
Requires-Dist: requests>=2.32.3
Requires-Dist: rich>=14.0.0
Requires-Dist: six>=1.17.0
Requires-Dist: sniffio>=1.3.1
Requires-Dist: soupsieve>=2.7
Requires-Dist: typing-inspection>=0.4.0
Requires-Dist: typing_extensions>=4.13.2
Requires-Dist: tzdata>=2025.2
Requires-Dist: urllib3>=2.4.0
Requires-Dist: xlrd>=2.0.1
Requires-Dist: XlsxWriter>=3.2.3
Requires-Dist: yt-dlp>=2025.5.22


# MTABE CLI - Your AI Study Assistant 🎓

MTABE is a powerful CLI tool that helps you study smarter using AI-powered flashcards and tests. It works with various content sources including YouTube videos, web pages, and local files.

## Installation

```bash
pip install mtabe
```

## Features

- 📝 Create AI-powered flashcards from any study material
- 📝 Generate custom tests with various question types
- 📺 Extract content from YouTube video subtitles
- 🌐 Pull study material from web pages
- 📄 Support for multiple file formats (PDF, DOCX, TXT, XLSX, etc.)

## Usage

### Adding Study Notes

```bash
# Add notes by typing/pasting
mtabe add-notes mynotes -t

# Add notes from a YouTube video
mtabe add-notes physics-lecture -y "https://youtube.com/watch?v=xxxxx"

# Add notes from a webpage
mtabe add-notes chemistry-notes -w "https://example.com/chemistry-lesson"

# Add notes from a local file
mtabe add-notes math-formulas -l "path/to/your/file.pdf"
```

### Creating Flashcards

```bash
# Create flashcards from saved notes
mtabe flash-card -f mynotes

# Create flashcards directly from YouTube
mtabe flash-card -y "https://youtube.com/watch?v=xxxxx"

# Create flashcards from a webpage
mtabe flash-card -w "https://example.com/lesson"

# Create flashcards from a local file
mtabe flash-card -l "path/to/your/file.pdf"
```

### Generating Tests

```bash
# Generate test from saved notes
mtabe test -f mynotes

# Generate test from YouTube content
mtabe test -y "https://youtube.com/watch?v=xxxxx"

# Generate test from a webpage
mtabe test -w "https://example.com/lesson"

# Generate test from a local file
mtabe test -l "path/to/your/file.pdf"
```

## Supported File Formats

- Text files (.txt)
- PDF documents (.pdf)
- Word documents (.docx)
- Excel spreadsheets (.xlsx, .xls, .xlsm)
- PowerPoint presentations (.pptx)
- CSV files (.csv)

## First-Time Setup

On first use, MTABE will prompt you to:
1. Enter your Groq API key (get it from https://console.groq.com/keys)
2. Provide your name
3. Specify your education level
4. Define your area of focus (IT, CS, Science, etc.)

This information helps MTABE personalize your learning experience.

## Tips for Best Results

- When requesting flashcards, specify the number you want (e.g., "Give me 10 cards")
- For tests, you can specify question types:
  - Multiple choice
  - True/false
  - Essay
  - Fill in the blank
  - Short explanation
  - Short answer
  - Mix of different types

## Example Commands

```bash
# Create 10 flashcards from a YouTube lecture
mtabe flash-card -y "https://youtube.com/watch?v=xxxxx"

# Generate a mixed test from saved notes
mtabe test -f chemistry-notes

# Add notes from a PDF textbook
mtabe add-notes chapter5 -l "textbook/chapter5.pdf"
```
