tesseract-rs is a Rust binding for Tesseract OCR with built-in compilation of Tesseract and Leptonica libraries. This project aims to provide a safe and idiomatic Rust interface to Tesseract's functionality while handling the complexity of compiling the underlying C++ libraries.
- Safe Rust bindings for Tesseract OCR
- Built-in compilation of Tesseract and Leptonica
- Automatic download of Tesseract training data
- High-level Rust API for common OCR tasks
Add this to your Cargo.toml:
[dependencies]
tesseract-rs = { version = "0.1.18", features = ["build-tesseract"] }To build this crate, you need:
- A C++ compiler (e.g., gcc, clang)
- CMake
- Internet connection (for downloading Tesseract training data)
Here's a basic example of how to use tesseract-rs:
use tesseract_rs::TesseractAPI;
fn main() -> Result<(), Box<dyn std::error::Error>> {
let api = TesseractAPI::new();
api.init("path/to/tessdata", "eng")?;
// Assume we have a 3x3 black and white image with a "1"
let image_data: Vec<u8> = vec![
0xFF, 0x00, 0xFF,
0x00, 0x00, 0xFF,
0x00, 0x00, 0xFF,
];
api.set_image(&image_data, 3, 3, 1, 3);
api.set_variable("tessedit_char_whitelist", "0123456789")?;
let text = api.get_utf8_text()?;
println!("Recognized text: {}", text);
Ok(())
}The crate will automatically download and compile Tesseract and Leptonica during the build process. This may take some time on the first build.
For more detailed information, please check the API documentation.
This project is licensed under the MIT License - see the LICENSE file for details.
Contributions are welcome! Please feel free to submit a Pull Request.
This project uses Tesseract OCR and Leptonica. We are grateful to the maintainers and contributors of these projects.