unstar
A simple Python package to automate the removal of GitHub stars from your account.
Features
- Remove all starred repositories from your GitHub account
- Built with modern Python packaging using
uv - Command-line interface for easy usage
- Rate limiting to respect GitHub API limits
Installation
From PyPI (recommended)
# Install using uv (recommended)
uv tool install unstar
# Or install using pip
pip install unstar
From Source
git clone https://github.com/forkdo/unstar
cd unstar
uv sync
# or if you have `uv` installed globally
uv tool install -e
Usage
Command Line Interface
After installation, you can use the unstar command:
unstar <your_github_access_token>
Getting a GitHub Access Token
- Go to GitHub Settings > Personal Access Tokens
- Click "Generate new token (classic)"
- Select the following scopes:
public_repo(to access public repositories)user(to access starred repositories)
- Copy the generated token
Example
unstar ghp_your_token_here
Development
This project uses uv for dependency management and packaging.
Setup Development Environment
git clone https://github.com/forkdo/unstar
cd unstar
uv sync
Running from Source
uv run unstar <access_token>
# or
uv run python -m unstar.main <access_token>
Building the Package
uv build
Publishing to PyPI
# Build the package
uv build
# Publish to PyPI (requires authentication)
uv publish
Requirements
- Python 3.8+
requestslibrary- Valid GitHub personal access token
License
This project is licensed under the Apache License 2.0 - see the LICENSE file for details.
Contributing
- Fork the repository
- Create a feature branch
- Make your changes
- Run tests (if available)
- Submit a pull request
Disclaimer
Use this tool responsibly. Make sure you really want to unstar all your repositories before running it, as this action cannot be easily undone.
Metadata
Release files for unstar 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| unstar-0.1.0.tar.gz | 11.2 kB | Without provenance | Details for unstar-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| unstar-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for unstar-0.1.0-py3-none-any.whl |
Total release size: 19.4 kB
Release files / unstar-0.1.0.tar.gz
| Download URL | unstar-0.1.0.tar.gz |
|---|---|
| Size | 11.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
ac8d75fd3ec0ee5564b01553b9bec06867be894821b28ccfa7f4ed8222086800
|
|
BLAKE2b-256 checksum How to use checksums |
8bd3f3ab55fb80e8057bb3f42d1dd5827c7efd93afc5235e1a3560ac12450e3c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.8.22
|
Release files / unstar-0.1.0-py3-none-any.whl
| Download URL | unstar-0.1.0-py3-none-any.whl |
|---|---|
| Size | 8.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
a55cc043015cc87fec4c66179df29ddb8543a58e7b3896d736ed6bd9e1d5e2dd
|
|
BLAKE2b-256 checksum How to use checksums |
a59321cf7cab084a3e422157b6f11cbd21b9d31083da10f184bf317720dd8ece
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.8.22
|
Security for unstar 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.