Skip to main content

Add your description here

Project description

Quack2Tex 🦆

Ever found yourself battling with equations while writing papers in LaTeX, wishing there was a way to just snap a picture and boom—LaTeX code? Well, I did too. After too many late nights and too much coffee, I finally decided to do something about it. The result? Quack2Tex.

Quack2Tex is a handy tool that facilitates turning images of math equations and charts into LaTeX code, quickly and easily!. But it doesn't stop there! It also has cool features like guessing the location from a photo, identifying recipes from food pictures, and explaining code from images. Rendered as a floating menu on your screen, Quack2Tex is always at your fingertips, making it easy to access anytime you need it.

🚀 Features

  • 2024-10-18: Quack2Tex v1.0.0 is out! 🎉

    • Added functionality for users to customize the rubber-duck menu. A new "Settings" option allows users to create and manage custom actions.
    • Action Grouping: Users can now group actions in the settings menu for better organization and streamlined access.
    • Multimodal Selection: Users can now choose which model or combination of models to use for generating outputs, enhancing flexibility and multimodel inference.
    • New Input Mode: A "Clipboard" input mode has been introduced, enabling users to use clipboard content as input for selected actions.
  • 2024-9-10: Quack2Tex was released! 🎉

    • Image to LaTeX: Convert pictures of equations or symbols into LaTeX code—no more manual typing!
    • Location Guessing: Upload a photo, and Quack2Tex will try to figure out where it was taken.
    • Recipe Finder: Snap a picture of your meal, and Quack2Tex will tell you what dish it is.
    • Code Explainer: Got a screenshot of code? Quack2Tex can explain what it does.

See the video below for a demo of Quack2Tex in action:

Watch the video

🧠 Powered By

Under the hood, Quack2Tex leverages state-of-the-art multimodal models like Gemini, GPT-4o, and Lava to analyze the content in the images. Whether you're converting handwritten notes into LaTeX or identifying the location of a stunning sunset photo, Quack2Tex has you covered.

🔧 Installation

To get started with Quack2Tex, follow these steps:

pip install quack2tex

📚 Usage

In the terminal, run the following command:

quack2tex --google_api_key <GOOGLE_API_KEY> --openai_api_key <OPENAI_API_KEY>

make you set the env variables GOOGLE_API_KEY and/or OPENAI_API_KEY for using google and openai models respectively. You can also use LLava models through the ollama api. You can also run the app from python, see the main.py file for an example.

📝 Roadmap

  • Support clipboard copy to be used in the prompt
  • Support gemini, gpt-4o, and lava models
  • Allow user add custom actions to the rubber-duck menu
  • Persist images and results in a database
  • Create window, mac, and linux executables

🤝 Contributing

Want to help make Quack2Tex better? Feel free to contribute by following these steps:

  1. Fork the repo.
  2. Create a new branch.
  3. Make your changes.
  4. Commit and push your changes.
  5. Open a Pull Request.

🛠️ Troubleshooting

If you run into any problems, check out the Issues section on GitHub.

📄 License

Quack2Tex is open-source and available under the MIT License—see the LICENSE file for more details.

📧 Contact

Got questions? You can reach out to me at henryruiz22@gmail.com.

Project details


Download files

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

Source Distribution

quack2tex-1.0.3.tar.gz (17.6 MB view details)

Uploaded Source

Built Distribution

quack2tex-1.0.3-py3-none-any.whl (4.6 MB view details)

Uploaded Python 3

File details

Details for the file quack2tex-1.0.3.tar.gz.

File metadata

  • Download URL: quack2tex-1.0.3.tar.gz
  • Upload date:
  • Size: 17.6 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.4.21

File hashes

Hashes for quack2tex-1.0.3.tar.gz
Algorithm Hash digest
SHA256 d179819d34f0a1e1af79bfaf96e9369d319454c1690054587173bbda8fdcf32c
MD5 da0c59142e6b8970287e787f352f3d2d
BLAKE2b-256 8eb156f50c20c8658795112b506b5ad67c1444189ef145b13ea658509f857152

See more details on using hashes here.

File details

Details for the file quack2tex-1.0.3-py3-none-any.whl.

File metadata

File hashes

Hashes for quack2tex-1.0.3-py3-none-any.whl
Algorithm Hash digest
SHA256 38815b83a661b00c789f6de9f4ed4d9a9575b02c646386a0b2793fdb2a558911
MD5 b145275f729d4e4d1e2402bb685b284f
BLAKE2b-256 fcf9fb97577113f00017b787510d63922a289a76cd7d1b1c9527c7e520510b7c

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page