OJHunt Lite

A lightweight async Python tool for querying Online Judge (OJ) statistics across multiple platforms. Track your accepted problems and total submissions from competitive programming sites.

Async/concurrent requests via aiohttp
CLI and web interface
BSD-2 Licensed

CLI

Install once, use anywhere (pipx, uv tool, or pip):

pipx install ojhunt
# or: uv tool install ojhunt
# or: pip install ojhunt

Run directly from a clone (no install needed):

git clone https://github.com/Liu233w/ojhunt-lite
cd ojhunt-lite
uv run ojhunt tourist@codeforces

Run via container (no Python needed):

docker run --rm ghcr.io/liu233w/ojhunt-lite tourist@codeforces

Example output:

$ ojhunt tourist@codeforces tourist@atcoder
Querying CodeForces...
Querying AtCoder...
AtCoder done (1051 solved, 1.25s)
CodeForces done (2962 solved, 2.78s)

Total: 2962 solved / 6437 submissions

┏━━━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━┳━━━━━━━━━━━━┓
┃ Crawler    ┃ Username ┃ Solved ┃ Submissions ┃ Status     ┃
┡━━━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━╇━━━━━━━━━━━━┩
│ CodeForces │ tourist  │   2962 │        5386 │ OK (2.78s) │
│ AtCoder    │ tourist  │   1051 │        1051 │ OK (1.25s) │
└────────────┴──────────┴────────┴─────────────┴────────────┘
Completed: 2 OK, 0 failed (2.78s total)

Full CLI reference, login-required crawlers, and JSON output: docs/cli.md

Web Interface

The web interface is designed to be self-hosted. Clone the repo and deploy:

git clone https://github.com/Liu233w/ojhunt-lite
cd ojhunt-lite
uv sync
uv run fastapi run src/ojhunt/web/app.py --port 8080

Container images are available at ghcr.io/liu233w/ojhunt-lite — see docs/web.md.

Use Crawlers in Your Code

Add ojhunt as a project dependency:

uv add ojhunt
# or: pip install ojhunt

Sync (simplest):

from ojhunt.crawlers.codeforces import query
from ojhunt.crawlers import query_sync

result = query_sync(query, "tourist")
print(result.solved, result.submissions, result.solved_list)

Async (when you already have an event loop):

import asyncio, aiohttp
from ojhunt.crawlers.codeforces import query
from ojhunt.crawlers import CrawlerResult

async def main():
    async with aiohttp.ClientSession() as session:
        result = CrawlerResult.from_dict(await query(session, "tourist"))
        print(result.solved, result.submissions, result.solved_list)

asyncio.run(main())

query_sync and CrawlerResult work with any crawler in ojhunt.crawlers.*. Some crawlers (nit, uva) use a persistent label cache and require the full package — they cannot be used as standalone copied files.

Supported Platforms

See the src/ojhunt/crawlers/ directory. Archived crawlers (dead sites) are in archived_crawlers/.

Development

Adding crawlers, running tests, templates: docs/development.md

License

BSD 2-Clause License — see individual crawler files for full license text.

Credits

Lightweight Python rewrite of OJHunt (acm-statistics), originally inspired by 西北工业大学ACM查询系统 (npuacm.info) by Jiduo Zhang.

Special thanks to test account providers: @leoloveacm, @2013300262

Contributors ✨

Thanks goes to these wonderful people (emoji key):

_==🔗 🐛	_{Adelard Collins🔗} 🐛	_{BackSlashDelta🔗} 🐛	_{Bodhisatan_Yao🔗} 🐛	_Claude🔗 💻 🚇 ⚠️	_{Geekxiong🔗} 🤔
_Halorv🔗 🤔	_{Kido Zhang🔗} 🚇 🤔	_Liu233w🔗 💻 🤔 🚇 ⚠️	_Meulsama🔗 🤔	_{Michael Xiang🔗} 🐛	_Zhao🔗 🐛
_bLue🔗 💻	_{bluebear4🔗} 🐛	_ct🔗 🐛	_flylai🔗 💻 🐛	_{fzu-h4cky🔗} 🐛	_wwawwaww🔗 🐛
_zby🔗 🤔 🐛

This project follows the all-contributors specification. Contributions of any kind welcome!

Environment
- Console
License
- OSI Approved :: BSD License
Programming Language
- Python :: 3
Topic
- Internet :: WWW/HTTP

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ojhunt-2026.7.19.161459.tar.gz (3.4 MB view details)

Uploaded Jul 19, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

ojhunt-2026.7.19.161459-py3-none-any.whl (1.4 MB view details)

Uploaded Jul 19, 2026 Python 3

File details

Details for the file ojhunt-2026.7.19.161459.tar.gz.

File metadata

Download URL: ojhunt-2026.7.19.161459.tar.gz
Upload date: Jul 19, 2026
Size: 3.4 MB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for ojhunt-2026.7.19.161459.tar.gz
Algorithm	Hash digest
SHA256	`af3b17d8d300e5f10a510aadc6723bccc3bf35b7aa3f3bc2fa30df2a12fcdb19`
MD5	`fd1dde7cf817127d243d91647f253dc0`
BLAKE2b-256	`a9fe3b679d2fbac034f07b88ad05794bfd7244dbc7045e51566b01882c89612f`

See more details on using hashes here.

Provenance

The following attestation bundles were made for ojhunt-2026.7.19.161459.tar.gz:

Publisher: release.yml on Liu233w/ojhunt-lite

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: ojhunt-2026.7.19.161459.tar.gz
- Subject digest: af3b17d8d300e5f10a510aadc6723bccc3bf35b7aa3f3bc2fa30df2a12fcdb19
- Sigstore transparency entry: 2202081433
- Sigstore integration time: Jul 19, 2026
Source repository:
- Permalink: Liu233w/ojhunt-lite@37fffbd079a1ae70893ee487ed245a2a0e0b879d
- Branch / Tag: refs/heads/main
- Owner: https://github.com/Liu233w
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@37fffbd079a1ae70893ee487ed245a2a0e0b879d
- Trigger Event: workflow_run