semvec/pypi-packages huggingface dataset:
athenanewsapi 0.1.3
A simple wrapper for the Athena News API to simplify searching for articles.
Requires Python: >=3.6

# Athena News API Wrapper

A simple Python wrapper for the [Athena News API](https://runathena.com) that simplifies querying and retrieving news articles.

## Features

- **Simplified API Access:** Easily send queries to the Athena News API.
- **Automatic Polling:** Automatically polls until the query is processed.
- **Pagination Handling:** Fetches all available articles across multiple pages.

## Installation

Install the package via pip (after publishing to PyPI):

`pip install athenanewsapi`

Or install directly from source:

```
git clone https://github.com/athenanewsapi/athenanews.git
cd athenanewsapi
pip install .
```
Then get your API key by [creating an Athena account](https://app.runathena.com/register). 

## Usage

Import the package and call the news function with the required parameters:

```
from athenanewsapi import news

articles = news(
    start_date="2025-03-01T15:13:52.466Z",
    end_date="2025-03-20T15:13:52.466Z",
    query="Tesla dealership protests",
    key_phrases="('tesla takedown')",
    toggle_state="All Articles",
    api_key="YOUR_API_KEY"
)

print("Total articles fetched:", len(articles))
```

## API Reference

news(start_date, end_date, query, key_phrases, toggle_state, api_key)

- **start_date (str):** ISO formatted start date.
- **end_date (str):** ISO formatted end date.
- **query (str):** The search query.
- **key_phrases (str) OPTIONAL:** Key phrases to refine the search. (ex: `('elon' or 'musk') and not 'sam altman'`)
- **toggle_state (str) OPTIONAL:** The toggle state (e.g., "All Articles" or "Encoded Articles").
- **api_key (str):** Your Athena API key.

**Returns:**
A list of articles returned by the API.

## Contributing
Contributions are welcome! Please open an issue or submit a pull request on GitHub.
stock-watch 0.1
Deliver live data for your portfolio in your terminal
Requires Python: >=3.8

# stock-watcher
Deliver live data for your portfolio in your terminal

## Build
Install using pip:
```
pip install stock_watcher
```

## Usage
The interface is overall very simple:
```
usage: stock-watcher [-h] [-f FROM] config_csv

Deliver live data for your portfolio in your terminal

positional arguments:
  config_csv       config csv with your portfolio

options:
  -h, --help       show this help message and exit
  -f, --from FROM  currency to display USD exchange rate for (default: CAD)
```

Here's an example configuration csv:

| Ticker | Buy Price | Num Stocks |
| ------ | --------- | ---------- |
| SCHH | 19.98 | 59 |
| VTC | 75.77 | 18 |
| SPTM | 64.02 | 50 |
| SPDW | 35.68 | 75 |
| VWO | 41.94 | 55 |
| MMKT | 100.03 | 7 |
| 6758.T | 2618.00 | 51 |

In text it might look like this:
```
Ticker,Buy Price,Num Stocks
SCHH,19.98,59
VTC,75.77,18
SPTM,64.02,50
SPDW,35.68,75
VWO,41.94,55
MMKT,100.03,7
6758.T,2618.00,51
```
The seperator will be automatically detected by pandas, so you can use pretty much whatever you want. The ticker in the first column must be availible on yahoo finance. Any securities that use a currency other than USD should have their buy price entered in the local currency.

## Features
[Put a screenshot here]
The program gives 4 data points for each ticker, The % and absolute daily and total change. The daily changes are calculated from the last price point before today. It also shows whether US markets are currently open or closed. Fianlly, a currency exchange rate is displayed at the bottom. Absolute data for foreign securities is always converted to USD when displayed (though calculations are done in local currency). However percent changes are done in local currencies.

`q` is used to exit the program.
portfolio-watcher 0.1
Deliver live data for your portfolio in your terminal
Requires Python: >=3.8

# stock-watcher
Deliver live data for your portfolio in your terminal

## Build
Install using pip:
```
pip install stock_watcher
```

## Usage
The interface is overall very simple:
```
usage: stock-watcher [-h] [-f FROM] config_csv

Deliver live data for your portfolio in your terminal

positional arguments:
  config_csv       config csv with your portfolio

options:
  -h, --help       show this help message and exit
  -f, --from FROM  currency to display USD exchange rate for (default: CAD)
```

Here's an example configuration csv:

| Ticker | Buy Price | Num Stocks |
| ------ | --------- | ---------- |
| SCHH | 19.98 | 59 |
| VTC | 75.77 | 18 |
| SPTM | 64.02 | 50 |
| SPDW | 35.68 | 75 |
| VWO | 41.94 | 55 |
| MMKT | 100.03 | 7 |
| 6758.T | 2618.00 | 51 |

In text it might look like this:
```
Ticker,Buy Price,Num Stocks
SCHH,19.98,59
VTC,75.77,18
SPTM,64.02,50
SPDW,35.68,75
VWO,41.94,55
MMKT,100.03,7
6758.T,2618.00,51
```
The seperator will be automatically detected by pandas, so you can use pretty much whatever you want. The ticker in the first column must be availible on yahoo finance. Any securities that use a currency other than USD should have their buy price entered in the local currency.

## Features
[Put a screenshot here]
The program gives 4 data points for each ticker, The % and absolute daily and total change. The daily changes are calculated from the last price point before today. It also shows whether US markets are currently open or closed. Fianlly, a currency exchange rate is displayed at the bottom. Absolute data for foreign securities is always converted to USD when displayed (though calculations are done in local currency). However percent changes are done in local currencies.

`q` is used to exit the program.
khutbahmaker 25.3.5
Generate Islamic Friday sermons (khutbah) using AI (#GodamSahur 2025)
Requires Python: >=3.8

# khutbahmaker

Generate Islamic Friday sermons (khutbah) using AI (#GodamSahur 2025).

![KhutbahMaker Web UI](assets/thumb.webp)

## Installation

```bash
pip install khutbahmaker
```

## Key Features

- 📝 **Content Generation**
  - Topic-based Khutbah Generation
  - Multiple Language Support
  - Adjustable Length Options
  - Various Tone Settings
- 📊 **Output Formats**
  - Professional PDF Generation
  - Clean Markdown Text
  - RTL Support for Arabic
  - Beautiful Typography
- 🌐 **Flexible Integration**
  - Interactive Web UI
  - Python Library
  - Customizable Settings

## Usage

### Python Library

```python
from khutbahmaker import KhutbahMaker

# Initialize
client = KhutbahMaker(
    mode="default",                               # Mode (default/webui)
    api_key="YOUR_KEY",                           # AI service API key
    model="gemini-2.0-flash-thinking-exp-01-21"   # AI model to use
    timeout=180                                   # AI request timeout in seconds
)

# Generate khutbah
pdf_file, markdown_text = client.generate_khutbah(
    topic="Ramadan Preparation",   # Main topic/theme
    length="Short",                # short/medium/long
    tone="Inspirational",          # Tone of the khutbah
    language="Bahasa Malaysia"     # Target language
)
```

### Web UI

Start the Gradio web interface:

```python
client = KhutbahMaker(mode="webui")
# OR
client.start_webui(
    host="localhost",    # Server host
    port=7860,           # Server port
    browser=False,       # Launch browser
    upload_size="4MB",   # Max upload size
    public=False,        # Enable public URL
    limit=10,            # Max concurrent requests
    quiet=False          # Quiet mode
)
```

## Configuration

### Target Languages
- Bahasa Malaysia
- Arabic
- English
- Mandarin
- Tamil

### Khutbah Lengths
- **Short**: 10-15 minutes
- **Medium**: 15-20 minutes
- **Long**: 20-30 minutes

### Tone Options
- Scholarly
- Inspirational
- Practical
- Reflective
- Motivational
- Educational
- Historical
- Narrative

### PDF Result Format
- Professional Title
- Opening Praises
- Quranic Verses & Hadith
- Main Content
- Practical Advice
- Closing Prayers
- RTL Support for Arabic

## License

See [LICENSE](LICENSE) for details.
dalle-generator 25.3.5
A simple image generator that focuses on prompt adherence and aesthetics.
Requires Python: >=3.8
Keywords: dalle-generator, dalle_generator

# dalle-generator

An image generator that focuses on prompt adherence and unique aesthetics.

## Installation

```bash
pip install dalle-generator
```

## Key Features

- 🎨 **Image Generation**
  - Text-to-Image Generation
  - Multiple Image Output
  - Smart Prompt Handling
- 🔄 **Flexible Integration**
  - Interactive Web UI
  - REST API Server
  - Python Library
- 💾 **Output Management**
  - Multiple Output Formats
  - Date-based Organization
  - Automatic File Naming

## Usage

### Python Library

```python
from dalle_generator import DalleGenerator

# Initialize
client = DalleGenerator(
    mode="default",       # Mode (default/webui/api)
    log_on=True,          # Enable logging
    log_to=None,          # Log directory
    save_to="outputs",    # Output directory
    save_as="webp"        # Output format (webp/jpg/pil)
)

# Generate images
results = client.image_generate(
    prompt="a beautiful landscape"
)

# Returns list of file paths or PIL Images if save_as='pil'
```

### Web UI

Start the Gradio web interface:

```python
client = DalleGenerator(mode="webui")
# OR
client.start_webui(
    host="0.0.0.0",    # Server host
    port=7860,         # Server port
    browser=True,      # Launch browser
    upload_size="4MB", # Max upload size
    public=False,      # Enable public URL
    limit=10,          # Max concurrent requests
    quiet=False        # Quiet mode
)
```

### REST API

Start the Flask API server:

```python
client = DalleGenerator(mode="api")
# OR
client.start_api(
    host="0.0.0.0",    # Server host
    port=5734,         # Server port
    debug=False        # Enable debug mode
)
```

#### API Endpoints

- `POST /v1/api/image/generate`

## Configuration

### Output Formats
- `webp` - High quality, small size
- `jpg` - Standard compressed
- `pil` - PIL Image object

### Output Structure
```
outputs/
└── YYYY-MM-DD/
    ├── YYYYMMDD_HHMMSS_UUID8_1.webp
    ├── YYYYMMDD_HHMMSS_UUID8_2.webp
    └── ...
```

## License

See [LICENSE](LICENSE) for details.
open-trivia-database-wrapper 0.3.2
Python wrapper for the Open Trivia Database
Requires Python: >=3.11

# python-open-trivia-database-wrapper

A Python wrapper for the[ Open Trivia Database API](https://opentdb.com/).

To intall the package, run the following command:

```bash
pip install python-open-trivia-database-wrapper
```

## Usage

```python
from opentdb.opentdb import openTriviaDB, Parameters

trivia = openTriviaDB()
response = trivia.get_questions(category=Parameters.Category.GENERAL_KNOWLEDGE, number_of_questions=1)
```

The `Parameters` class is a helper class that contains enums for the different parameters that can be passed to the `get_questions` method . The `get_questions` method can take the following parameters:

```python
category: Parameters.Category
difficulty: Parameters.Difficulty
question_type: Parameters.QuestionType
number_of_questions: int
```

Example of all the parameters being used: 
```python
response = get_questions(category=Parameters.Category.GENERAL_KNOWLEDGE,
                         difficulty=Parameters.Difficulty.EASY,
                         question_type=Parameters.QuestionType.MULTIPLE,
                         number_of_questions=15)
```

If no parameters are passed in, then a set of 10 random questions will be returned

## Response

Example json response from API:

```json
{
    "response_code": 0,
    "results": [
        {
            "category": "General Knowledge",
            "type": "multiple",
            "difficulty": "easy",
            "question": "What is the most common surname Wales?",
            "correct_answer": "Jones",
            "incorrect_answers": [
                "Williams",
                "Davies",
                "Evans"
            ]
        }
    ]
}
 ```

In code, the response is modelled by a `Result` object, which has the following attributes:


```python
response_code: int
results: List[Question]
```

The `Question` object has the following attributes:

```python
type: str
difficulty: str
category: str
question: str
correct_answer: str
incorrect_answers: List[str]
```

So when looping over the list of results, you can access the attributes like so:

```python
for result in response.results:
    print(result.question)
    print(result.correct_answer)
    print(result.incorrect_answers)
```
citrailmu 25.3.8
Convert lectures/talks from video/audio/YouTube into text (#GodamSahur 2025)
Requires Python: >=3.8

# citrailmu

Convert lectures/talks from video/audio/YouTube into text (#GodamSahur 2025).

![CitraIlmu Web UI](assets/thumb.webp)

## Installation

```bash
pip install citrailmu
```

## Key Features

- 🎥 **Media Processing**
  - YouTube Video Support
  - Local Video/Audio Files
  - Web URL Support
  - Automatic Audio Compression
- 🔄 **Content Analysis**
  - Full Speech Transcription
  - Topic & Theme Analysis
  - Multi-language Support
  - PDF Report Generation
- 🌐 **Flexible Integration**
  - Interactive Web UI
  - Python Library
  - File & URL Processing

## Usage

### Python Library

```python
from citrailmu import CitraIlmu

# Initialize
client = CitraIlmu(
    mode="default",               # Mode (default/webui)
    api_key="YOUR_KEY",           # AI service API key
    model="gemini-1.5-flash-8b",  # AI model to use
    yt_api=False,                 # Use YouTube API (optional)
    yt_api_key="YOUR_YT_API_KEY"  # YouTube API key (optional)
)

# Process media (file/URL)
audio_file, pdf_file, markdown_text = client.process_media(
    input_path="path/to/video.mp4",     # Audio/video file path or URL
    target_language="Bahasa Malaysia",  # Target language
    processing_mode="Analysis"          # Analysis/Transcript
)
```

### Web UI

Start the Gradio web interface:

```python
client = CitraIlmu(mode="webui")
# OR
client.start_webui(
    host="localhost",    # Server host
    port=7860,           # Server port
    browser=False,       # Launch browser
    upload_size="100MB", # Max upload size
    public=False,        # Enable public URL
    limit=10,            # Max concurrent requests
    quiet=False          # Quiet mode
)
```

## Configuration

### Target Languages
- Bahasa Malaysia
- Arabic
- English
- Mandarin
- Tamil

### Processing Modes
- **Analysis**: Full content analysis with topics and themes
- **Transcript**: Complete speech-to-text conversion

### YouTube Processing Options
- **API Mode**: Uses web API for video downloading (requires API key)
- **Default Mode**: Uses native method for video downloading (no API key required)

### PDF Result Format
- Title and Overview
- Topics and Themes (Analysis mode)
- Full Transcript
- Clean Typography and Layout
- RTL Support for Arabic

## License

See [LICENSE](LICENSE) for details.
open-trivia-database-wrapper-test 0.3.0
Python wrapper for the Open Trivia Database
Requires Python: >=3.11

# python-open-trivia-database-wrapper

A Python wrapper for the[ Open Trivia Database API](https://opentdb.com/).

To intall the package, run the following command:

```bash
pip install python-open-trivia-database-wrapper
```

## Usage

```python
from opentdb.opentdb import openTriviaDB, Parameters

trivia = openTriviaDB()
response = trivia.get_questions(category=Parameters.Category.GENERAL_KNOWLEDGE, number_of_questions=1)
```

Example response:

```json
    {
        "response_code": 0,
        "results": [
            {
                "category": "General Knowledge",
                "type": "multiple",
                "difficulty": "easy",
                "question": "What is the most common surname Wales?",
                "correct_answer": "Jones",
                "incorrect_answers": [
                    "Williams",
                    "Davies",
                    "Evans"
                ]
            }
        ]
    }
 ```
gamest-retroarch-identifier-plugin 1.0.1
Identify games running in retroarch.

# Gamest Retroarch Identifier Plugin

This plugin enables [gamest](https://github.com/sopoforic/gamest) to
identify games running in retroarch.

## Installation

Install with pip:

```
pip install gamest-retroarch-identifier-plugin
```

## License

Copyright (C) 2018  Tracy Poff

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.