THE OneKit GUIDE

How to use OneKit.
Browser, workflows and CLI.

Meet your toolkit for everyday files. Learn the basics, connect tools into a workflow, or take OneKit to your terminal.

ONE TOOLKIT, THREE WAYS TO WORK

What is OneKit?

OneKit helps you compare, convert and process PDFs, images, documents, code and other files. Use a single tool for a quick task, connect tools for a repeated job, or run the shared Python core from your command line.

FIND THE RIGHT OPERATION

Tools and categories

The catalog contains 285 tools; 255 currently run in the browser. Search by task or format, then use the category filters to narrow the list. Enable Show CLI tools to see operations available through the CLI with their required dependencies.

LOCAL BY DESIGN

Use a tool in your browser

Thanks to advanced browser technology, OneKit processes your files directly on your device. Your documents and results stay with you, without being uploaded to our servers. OneKit downloads the processing environment and required packages, then reuses them as you move between tools.

  1. Open a tool. Choose an operation from the catalog and check its input requirements.
  2. Add your input. Select files or paste text where supported. Use Replace or Remove to change the selection.
  3. Set the options. Choose the output format or settings. Supported PDF tools offer page previews and reordering; image cropping offers a visual selection.
  4. Run and download. Wait for processing to finish, inspect any warnings, then download the result. Save it before refreshing or closing the page.
The first run may take a little longer.

OneKit prepares its local environment in the background. Public downloads can be cached for future visits. Your working files are not stored in that cache. Cancelling an operation stops the processing environment.

UNDERSTAND YOUR RESULTS

Results, fidelity and comparisons

What do ✓ and ≈ mean?

✓ Content preserving: the operation is designed to preserve the relevant content. ≈ Conversion with compromises: layout, fonts, metadata or detail may change. Hover or focus the symbol on a tool card to read its specific explanation.

How do comparisons and merging work?

Open two files or paste two texts. Additions appear in green and removals in red. Use the arrows on individual changed lines to apply either version to the other side, one change at a time. You can keep editing and download either side. JSON comparisons normalize keys; notebook comparisons can focus on code, Markdown or both.

CONNECT YOUR TASKS

What does a workflow do?

Combine tools across categories in a single workflow: convert a file, process its contents, then compress or package the result. Mix and repeat steps as needed, provided each tool accepts the output format and file count from the previous step. OneKit passes results between steps automatically, without downloading and choosing files in between.

Processing several files? Use a workflow. Choose a pool of files: single-file tools run in a For each file loop, applying the same settings to every input. Each pass sends its results to the next step. Tools such as Merge PDF process the group together, in the selected order. Comparisons and diffs are excluded because they require a specific pair of inputs.

Explore an example
Your PDFRemove page 1Rotate remaining pagesA ready-to-save PDF

Remove a cover page, then rotate the remaining pages by 90°. Use a PDF with at least two pages. You can change both settings after opening this setup.

Open workflow builder →

This is a setup example, not a live file operation. In the builder, choose Open workflow to load the downloaded .1kit file, then add your own files.

  1. Start with a file pool

    Choose one or more inputs and the first tool. Add, remove or reorder files before running.

  2. Build your sequence

    Combine compatible tools from any category. Repeat steps and adjust their options.

  3. Run and reuse

    Run the workflow, download your results and save the setup for next time.

Steps run in numbered order; moving blocks changes only their position. The pool supports up to 256 files and 128 MiB total; each step also keeps its own file size and total limits. A failure stops the workflow without publishing partial results. Download multiple results together as a ZIP. A saved .1kit setup preserves tools, options and layout, without input files or passwords.

You can also run a saved setup from the CLI:

onekit cli
onekit pipeline --steps workflow.1kit input.pdf -o output/
FOR YOU & YOUR LOCAL AGENTS

Your CLI. Your agentic CLI.

The CLI gives you direct access to the Open Source (PolyForm Shield 1.0.0) Python core at the heart of OneKit. Run all 285 tools, including those not yet available in the browser, with more generous file-size limits where supported. Everything runs on your machine.
Requires Python 3.11 or later. Limits vary by tool; some operations need optional packages or external engines such as FFmpeg, LibreOffice or Pandoc.

onekit cli
python -m pip install "onekit-tools[pdf,images,documents]"

Use OneKit directly or as a local toolkit for an AI agent that can execute shell commands. Your agent can discover tools, check requirements, process files and run saved .1kit workflows. File processing runs locally; what reaches a remote model depends on your agent configuration.

Discover and check

onekit cli
onekit list --json
onekit doctor pdf-merge --json

Try a PDF merge

onekit cli
onekit run pdf-merge first.pdf second.pdf -o combined.pdf

For agent workflows, parse discovery and readiness JSON, pass explicit input/output paths and check the exit status before reading results. run and pipeline write output files; some tools produce JSON reports. Prepare dependencies before unattended runs, since first-use setup may need downloads or interaction. Use onekit doctor TOOL_ID to check the dependencies for a specific tool. OneKit preserves existing output files unless you deliberately pass --force. For passwords, use --ask-password to keep secrets out of shell arguments.

Help build OneKit's open revolution: everyday tools for everyone, from hands-on tasks to workflows run by local AI agents. Contribute to make tools more efficient and effective: improve speed and memory use, fix incorrect results, add regression examples, or clarify documentation and agent workflows. Read the contribution guide ↗

A FEW THINGS TO KNOW

Questions, limits and troubleshooting

What is a .1kit file?

.1kit is the OneKit file extension. It supports workflows and whiteboards. A saved workflow contains its tools, options and canvas layout; a saved whiteboard contains its notes, shapes and drawings. Open boards in Whiteboard and workflows in the workflow builder. New whiteboard and message files use compressed .1kit containers; legacy JSON and workflow files remain supported. Each file records its type and version. Workflow input files and passwords are excluded. Whiteboards contain the notes and drawings you save. Share creates an immutable hosted copy with an expiry and optional password encryption; editing your draft never changes an existing link. Whiteboards are available only in the webapp. For workflows, both the browser and CLI accept only .1kit workflow files.

How large can my files be?

The current file and total limits are shown in each tool’s upload area and requirements. They are selected automatically for your browser and device, within the tool’s processing constraints. Images also have pixel limits, and media tools have duration and resolution limits. Use smaller files or the OneKit CLI when an input or output exceeds the browser allowance. The CLI keeps its own limits independently of the browser.

Why are some tools available only in the CLI?

Tools that need additional models or native engines run in the CLI. Missing dependencies are installed automatically on first use, subject to platform availability. Use the tool’s CLI details page and onekit doctor TOOL_ID to see what it needs.

A workflow stops or a file is rejected. What should I check?

Check the actual file format, not just its extension, and the size limit shown for the selected tool. Each workflow step must accept the previous step’s output format and file count. A smaller-limit step cannot accept a larger result just because an earlier step supported it. Encrypted PDFs need the correct password. Try the step on its own to isolate the problem, or use the CLI for files beyond browser limits.

Can I close the tab or come back later?

Download your results before closing or refreshing. Working files and results live in the current session; reopening the site does not restore them. Save a workflow setup if you want to reuse its steps later, then choose the input files again.

How can I verify a download?

Use the versioned packages linked from the download page. They come directly from public GitHub Releases. Compare the file’s SHA-256 digest with the release manifest before installing. Optional native engines have their own platform requirements.

Does OneKit use analytics?

Optional Google Analytics loads only after you allow analytics cookies. You can change your choice using Cookie settings in the footer. File contents are not sent to Analytics. Read the privacy page for details.

BUILT IN THE OPEN

A toolkit you can inspect and improve

The OneKit Python core is Open Source (PolyForm Shield 1.0.0). Its code powers both the browser tools and the CLI. You can inspect the implementation, report a bug, suggest a tool or contribute a fix.

Help build OneKit's open revolution: everyday tools for everyone, from hands-on tasks to workflows run by local AI agents. Contribute to make tools more efficient and effective: improve speed and memory use, fix incorrect results, add regression examples, or clarify documentation and agent workflows. Read the contribution guide ↗

You may use, modify and redistribute the core for permitted purposes, including commercial and internal use. You may not use it to provide a product or service that competes with the software or with a product the licensor or its affiliates provides using the software; free offerings and different platforms or interfaces can also compete. When sharing copies, include the license text or its URL and any Required Notice lines supplied with the software. The full license governs, including its exceptions for new and discontinued products, patent terms and warranty disclaimer. Here, “Open Source (PolyForm Shield 1.0.0)” describes published source under these terms; the noncompete restriction means this is source-available software rather than unrestricted open source under the Open Source Definition.

Explore the OneKit repository

Source code, tool definitions, tests and contribution guidelines, all in one place.

View on GitHub ↗
KEEP THESE HANDY
GET IN TOUCH

Contact OneKit

Choose the right contact for your question.

Please send security reports privately and avoid attaching sensitive files or credentials.

Install OneKit

Keep OneKit in its own app window, with a shortcut on your device.