https://github.com/frissyn/valorant.py
Complete Python interface for the Valorant API. Works right out of the box!
https://github.com/frissyn/valorant.py
api api-wrapper client games python requests riot-games valorant
Last synced: 12 days ago
JSON representation
Complete Python interface for the Valorant API. Works right out of the box!
- Host: GitHub
- URL: https://github.com/frissyn/valorant.py
- Owner: frissyn
- License: mit
- Created: 2020-11-11T19:27:33.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2024-07-18T15:10:11.000Z (over 1 year ago)
- Last Synced: 2025-11-28T11:30:15.617Z (about 2 months ago)
- Topics: api, api-wrapper, client, games, python, requests, riot-games, valorant
- Language: Python
- Homepage: https://valorantpy.readthedocs.io
- Size: 321 KB
- Stars: 122
- Watchers: 3
- Forks: 19
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# valorant.py
[](https://actions-badge.atrox.dev/frissyn/valorant.py/goto?ref=master)
[](https://pypi.python.org/pypi/valorant)
[](https://pepy.tech/project/valorant)
[](https://discord.gg/b3qjk4epPr)
`valorant.py` is an unofficial API wrapper for Riot Games' Valorant API endpoints. It's modern, easy to use, feature-rich, and intuitive!
**[\*\*]** *Just a little note, the developement of this project will slow down a bit as I enter into college and other life stuff, but rest assured I don't plan on abandoning this. Thanks for understanding!*
## Features
+ **Simple:** High-level abstraction of API interactions; easy to use and easy to customize.
+ **Lightweight:** Doesn't rely on any external dependencies, minimal package size.
+ **Extensive:** Covers all Valorant related endpoints from the Riot Games API. Also includes Account coverage.
+ **Fast:** HTTP requests and object instancing optimized to use minimal resources and complete tasks quickly!
+ **Intuitive:** Complete auto-completion, docstrings, and type-hinting for all library objects and variables.
## Installation
`valorant.py` requires Python 3.8 or higher.
|Manager |Command |
|:----------:|:------------------------|
|PIP |`pip install valorant` |
|Poetry |`poetry add valorant` |
## Usage
Take a look at the [`examples/`](https://github.com/frissyn/valorant.py/blob/master/examples) folder for more usage snippets!
**Quickstart:**
```python
import valorant
KEY = "RGAPI-Key-Here"
client = valorant.Client(KEY)
agents = client.get_characters()
print(agents.get("Viper"))
```
**Local Client:**
```python
import valorant
client = valorant.LocalClient()
print(client.get_session())
```
**NOTE:** *The Local Client interacts with the Client API that Valorant uses while the game is running on your system. This means access to current player, friend requests, shop, etc. The Local Client is currently unstable. `valorant.py` is not liable for any punishment you may recieve should you use its tools to break Valorant ToS. (i.e Auto-Agent Selection)*
## Documentation
The public API documentation for `valorant.py` is hosted on [ReadTheDocs.io](https://valorantpy.readthedocs.io/en/latest/).
Use `bash bin/docs` to start the documentation server locally. This uses Ruby's `WEBrick` gem.
## Help and Questions
Have a bug or issue? Need help with the API? Open an [issue](https://github.com/frissyn/valorant.py/issues) or hop in the [#valorant-py](https://discord.gg/b3qjk4epPr) channel of the Frisscraft Community Discord Server.
## Contributing
Head over to the [**Contributing Guide**](https://github.com/frissyn/valorant.py/blob/master/.github/CONTRIBUTING.md) page.