Metadata-Version: 2.4
Name: gitlabrat
Version: 1.2
Summary: LabRat: GitLab exploitation orchestrator
Project-URL: Homepage, https://github.com/JChamblee99/LabRat
Project-URL: Repository, https://github.com/JChamblee99/LabRat.git
Project-URL: Issues, https://github.com/JChamblee99/LabRat/issues
Author-email: John Chamblee <conway.py@proton.farm>
License: GPL-3.0
License-File: LICENSE
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Requires-Python: >=3.8
Requires-Dist: beautifulsoup4>=4.9.0
Requires-Dist: gitpython>=3.1.0
Requires-Dist: python-gitlab>=3.0.0
Requires-Dist: requests>=2.25.0
Description-Content-Type: text/markdown

<div align="center">

# LabRat

**GitLab exploitation orchestrator.**

[![PyPI - Version](https://img.shields.io/pypi/v/gitlabrat)](https://pypi.org/project/gitlabrat/)
[![PyPI - Downloads](https://img.shields.io/pypi/dm/gitlabrat)](https://pypi.org/project/gitlabrat/)
[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)
[![GitHub last commit](https://img.shields.io/github/last-commit/JChamblee99/LabRat)](https://github.com/JChamblee99/LabRat/commits/main)

</div>

---

## Overview

LabRat automates common GitLab exploitation workflows: credential spraying, token creation, project enumeration, repository cloning, and bulk updates.

## Features

- **Authentication** — Spray credentials or combo lists across GitLab instances with optional LDAP support
- **Agent management** — Track access tokens and push SSH keys across available agents
- **Project operations** — Enumerate, clone, create access tokens, and perform procedural updates on repositories
- **User enumeration** — List users with advanced filtering and create access tokens

## Installation

```bash
pip install gitlabrat
```

> Requires **Python 3.8+**

## Quick Start

```bash
# Authenticate to a GitLab instance
labrat auth -t https://gitlab.example.com -u username -p password

# List authenticated agents
labrat agents ls
```

## Usage

```
labrat [-h] {agents,auth,projects,users} ...
```

## Dependencies

| Package | Purpose |
|---------|---------|
| [python-gitlab](https://python-gitlab.readthedocs.io/) | GitLab API client |
| [GitPython](https://gitpython.readthedocs.io/) | Git repository operations |
| [BeautifulSoup4](https://www.crummy.com/software/BeautifulSoup/) | HTML parsing for session auth |
| [Requests](https://docs.python-requests.org/) | HTTP session management |

## Disclaimer

This tool is intended for **authorized security testing and research only**. The author assumes no liability for misuse. Always obtain proper authorization before testing against any system you do not own.

## License

[GNU General Public License v3.0](LICENSE)
