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"
```
