Metadata-Version: 2.4
Name: formulens
Version: 0.1.0
Summary: NVIDIA GPU equation-to-LaTeX recognition with a Linux-first CLI.
Keywords: cli,configuration,equations,latex,linux,ocr
Author: Rajesh Das
Author-email: Rajesh Das <hyperoot.tech@proton.me>
License-Expression: MIT
License-File: LICENSE
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Science/Research
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Scientific/Engineering :: Mathematics
Requires-Dist: pydantic>=2.13.5
Requires-Dist: pyperclip>=1.11.0
Requires-Dist: rich>=15.0.0
Requires-Dist: typer>=0.27.2
Requires-Dist: utilityhub-config>=0.2.7
Requires-Dist: huggingface-hub>=1.31.0,<2 ; extra == 'ocr'
Requires-Dist: pillow>=12.3.0 ; extra == 'ocr'
Requires-Dist: torch>=2.14.1 ; extra == 'ocr'
Requires-Dist: transformers>=5.18.0 ; extra == 'ocr'
Requires-Python: >=3.14
Project-URL: Documentation, https://formulens.hyperoot.dev/
Project-URL: Homepage, https://formulens.hyperoot.dev/
Project-URL: Issues, https://github.com/HYP3R00T/formulens/issues
Project-URL: Repository, https://github.com/HYP3R00T/formulens
Provides-Extra: ocr
Description-Content-Type: text/markdown

<div align="center">

<h1>Formulens</h1>
<p>For the equations you'd rather understand than type.</p>

<p>
  <a href="https://pypi.org/project/formulens/"><img src="https://img.shields.io/pypi/v/formulens?style=flat-square" alt="PyPI version"></a>
  <a href="https://formulens.hyperoot.dev/user-guide/installation/"><img src="https://img.shields.io/badge/Python-3.14%2B-3776AB?style=flat-square&amp;logo=python&amp;logoColor=white" alt="Python 3.14+"></a>
  <a href="https://formulens.hyperoot.dev/user-guide/installation/"><img src="https://img.shields.io/badge/NVIDIA-CUDA-76B900?style=flat-square&amp;logo=nvidia&amp;logoColor=white" alt="NVIDIA CUDA"></a>
  <a href="https://github.com/HYP3R00T/formulens/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue?style=flat-square" alt="MIT license"></a>
</p>

<p>
  <a href="https://formulens.hyperoot.dev/">Documentation</a> ·
  <a href="https://formulens.hyperoot.dev/user-guide/installation/">Installation</a> ·
  <a href="https://github.com/HYP3R00T/formulens/issues">Issues</a>
</p>

</div>

Select an equation, get its LaTeX, and get back to your notes. Formulens runs
PaddleOCR-VL or GOT-OCR locally on your NVIDIA GPU and copies the result, ready
to paste. Its daemon keeps the model loaded between captures.

On COSMIC, bind a keyboard shortcut to open the screenshot selector. Temporary
captures are deleted after processing; existing images are preserved.

Requires **Python 3.14+** and **NVIDIA CUDA**. Native capture and daemon support
currently target Linux.

## Quick Start

Follow the [installation guide](https://formulens.hyperoot.dev/user-guide/installation/),
then keep the daemon running:

```bash
formulens daemon
```

From another terminal or your capture shortcut:

```bash
formulens capture
formulens recognize /path/to/equation.png --daemon
formulens daemon off
```

See the [docs](https://formulens.hyperoot.dev/) for shortcuts, configuration,
models, logs, and troubleshooting.

<p align="center">Built with ❤️ by <a href="https://github.com/HYP3R00T">@HYP3R00T</a></p>
