MCPcopy Index your code
hub / github.com/Nutlope/llama-ocr

github.com/Nutlope/llama-ocr @main

Chat with this repo
repository ↗ · DeepWiki ↗ · + Follow
5 symbols 12 edges 2 files 0 documented · 0%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README
<h1 align="center">Llama OCR</h1>

An npm library to run OCR for free with Llama 3.2 Vision.

Current version


Installation

npm i llama-ocr

Usage

import { ocr } from "llama-ocr";

const markdown = await ocr({
  filePath: "./trader-joes-receipt.jpg", // path to your image (soon PDF!)
  apiKey: process.env.TOGETHER_API_KEY, // Together AI API key
});

Hosted Demo

We have a hosted demo at LlamaOCR.com where you can try it out!

How it works

This library uses the free Llama 3.2 endpoint from Together AI to parse images and return markdown. Paid endpoints for Llama 3.2 11B and Llama 3.2 90B are also available for faster performance and higher rate limits.

You can control this with the model option which is set to Llama-3.2-90B-Vision by default but can also accept free or Llama-3.2-11B-Vision.

Roadmap

  • [x] Add support for local images OCR
  • [x] Add support for remote images OCR
  • [ ] Add support for single page PDFs
  • [ ] Add support for multi-page PDFs OCR (take screenshots of PDF & feed to vision model)
  • [ ] Add support for JSON output in addition to markdown

Credit

This project was inspired by Zerox. Go check them out!

Core symbols most depended-on inside this repo

main
called by 1
test/index.ts
ocr
called by 1
src/index.ts
getMarkDown
called by 1
src/index.ts
encodeImage
called by 1
src/index.ts
isRemoteFile
called by 1
src/index.ts

Shape

Function 5

Languages

TypeScript100%

Modules by API surface

src/index.ts4 symbols
test/index.ts1 symbols

For agents

$ claude mcp add llama-ocr \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact