semvec/pypi-packages huggingface dataset:
minion-works 0.0.1
Agents for menial tasks
License: MIT
Requires Python: >=3.7

<!-- Light/Dark Mode Banner Hack -->
<p align="center">
  <img src="static/minion-works-cover-light.png#gh-light-mode-only" alt="Minion Works" width="100%" />
  <img src="static/minion-works-cover-dark.png#gh-dark-mode-only" alt="Minion Works" width="100%" />
</p>

<h1 align="center"> MinionWorks – Modular browser agents that work for bananas 🍌</h1>

<p align="center">
  <em>Modular. Extensible. AI-native browser agents for modern web automation.</em>
</p>

---

## 🚀 Overview

Minion Works is a modular AI agent framework that connects to your browser and executes complex tasks autonomously. Built for developers, researchers, and curious builders.

### ✨ Features
- 🌐 Perform Google searches and scrape content
- 🤖 Use LLMs (like GPT-4) to plan actions
- 🔗 Modular architecture for plug-and-play use cases
- 🔎 DOM interaction & content extraction
- 🔄 Run workflows via Python or UI

---

## 🛠️ Installation

1. **Clone the repo**
   ```bash
   git clone https://github.com/minionworks/minions.git
   cd minions
   ```

2. **Create a virtual environment**
   ```bash
   python -m venv venv
   source venv/bin/activate  # or venv\Scripts\activate on Windows
   ```

3. **Install dependencies**
   ```bash
   pip install -r requirements.txt
   ```

4. **Configure environment**
   ```bash
   cp .env.example .env
   # Edit your .env file with OpenAI or other API keys
   ```

---

## 🧪 Quick Start

```bash
python -m src.agents.browser.main
```

Or run with PYTHONPATH if you’re outside the root:

```powershell
$env:PYTHONPATH = "C:\path\to\minions"
python -m src.agents.browser.main
```

---

## 🧠 Example Use Case

```python
agent = BrowserMinion(
    task="Find the top 3 ML conferences in 2025 and summarize each.",
    model="gpt-4"
)
agent.run()
```

Or check out this Notebook Example.

---

## 🧪 Testing

```bash
pytest --maxfail=1 --disable-warnings -q
```

Ensure you’re in the root folder where `tests/` lives.

---

## 🤝 Contributing

We welcome PRs, feedback, and creative ideas!
1. Fork → Branch → Commit
2. Add tests
3. Submit a Pull Request
4. Tell your friends 🚀

---

## 📖 Citation

```bibtex
@software{minion_works2025,
  author = {Sairaam, Aman, Cheena},
  title = {Minion Works: Let AI take the helm of your browser.},
  year = {2025},
  publisher = {GitHub},
  url = {https://github.com/minionworks/minions}
}
```

---
num2label 1.0.0.post1
A package to map numbers to text labels.
License: MIT
Requires Python: >=3.8

# num2label

A package to map numbers to text labels. For example, `n` maps to the `nth` letter of the alphabet. You can also map numbers to their corresponding spreadsheet column labels.

## Quick start

To get started, import `num2label`:

```python3
>>> import num2label
```

### Integer to letter

Map an integer to an uppercase letter of the alphabet:

```python3
>>> num2label.uppercase_letter(1)
'A'
```

Or a lowercase letter:

```python3
>>> num2label.lowercase_letter(26)
'z'
```

### Integer to spreadsheet column label

Map a number to a spreadsheet column label:

```python3
>>> num2label.spreadsheet_column(28)
'AB'
```

## Number bounds

The number must always be greater than zero. The number can be greater than 26. `uppercase_letter` and `lowercase_letter` will effectively loop the alphabet until the corresponding letter is reached (e.g., `27 => 'a'`, `55 => 'C'`). To ensure the number passed is strictly less than 27, pass `strict=True`. `num2label.lowercase_letter(27, strict=True)` will raise an error because the number is not between one and 26 (inclusive).