1
OneFile

Frequently Asked Questions

Everything you need to know about OneFile and bypassing AI upload limits.

Getting Started

What is OneFile?

OneFile is a free, open-source web application that combines multiple files into a single AI-ready text file. It solves the problem of file upload limits on AI platforms like ChatGPT, Claude, and Gemini by merging unlimited files into one.

How many files can I combine with OneFile?

There's no limit! You can combine 10, 100, or even 1,000+ files into one. The only constraint is your browser's memory, which can typically handle thousands of files without issues. We've tested with projects containing over 500 files successfully.

Do I need to create an account to use OneFile?

No account required! OneFile works completely anonymously. You only need to sign in with GitHub if you want to use the GitHub repository import feature. All other features work without any sign-up.

Is OneFile really free?

Yes, completely free with no hidden costs, no usage limits, and no premium tiers. OneFile is open-source software released under the MIT license. You can use it as much as you want, and even host your own version if desired.

AI Platforms

Does this work with ChatGPT's free plan?

Yes! ChatGPT free users are limited to uploading 3 files per day. With OneFile, you can merge unlimited files into one text file and upload that single file to ChatGPT, completely bypassing the 3-file restriction. Even ChatGPT Plus users benefit by avoiding the frustration of uploading files in batches of 10 for large projects.

Which AI platforms does OneFile work with?

OneFile works with all AI platforms that accept text file uploads, including ChatGPT (free and Plus), Claude (Sonnet and Opus), Google Gemini, Grok, Perplexity, and any other AI assistant. Since it outputs plain text, it's universally compatible.

What's the difference between uploading to ChatGPT vs Claude?

Both platforms work identically with OneFile's output. ChatGPT free limits you to 3 files per day, ChatGPT Plus to 10 files per message. Claude limits vary by plan. With OneFile, you bypass all these restrictions by uploading one combined file to either platform.

Can I use the output with GPT-4 or Claude Opus?

Absolutely! The combined text file works with all AI model versions - GPT-3.5, GPT-4, GPT-4 Turbo, Claude Sonnet, Claude Opus, Gemini Pro, and any other LLM. The format is universal plain text.

File Types & Uploads

What file types are supported?

OneFile supports 50+ file types including: PDFs (.pdf), Microsoft Office files (.docx, .xlsx, .pptx, .doc, .xls, .ppt), code files (.js, .py, .java, .cpp, .tsx, .jsx, .go, .rs, .rb, etc.), text files (.txt, .md, .csv, .tsv), configuration files (.json, .yaml, .yml, .xml, .toml, .ini, .env), web files (.html, .css, .scss), and many more. Images and binary files are automatically filtered out.

Can I upload an entire GitHub repository?

Yes! Use our GitHub import feature to browse and select files from any public repository. You can also download a repo as a ZIP file, extract it locally, and upload the entire folder by dragging it into OneFile. We automatically respect .gitignore files and skip node_modules, .git, and other unnecessary directories.

What happens to image files?

Image files (.jpg, .png, .gif, .svg, etc.) are automatically skipped and not included in the output. This is intentional - AI text models can't process images through text uploads, and including them would just add unnecessary content. You'll see a notification showing how many images were skipped.

How does OneFile handle large files?

Simple text files are processed instantly in your browser. Complex documents like PDFs, DOCX, and XLSX are processed server-side via an API route. Files are handled in-memory during the request and never persisted, which takes a few seconds. The combined output is optimized for AI context windows, typically staying under 1-2MB for easy uploading.

Can I upload files from Dropbox or Google Drive?

Not directly, but you can download files from Dropbox or Google Drive to your computer first, then upload them to OneFile. We may add direct cloud storage integration in the future based on user demand.

Privacy & Security

Is my data private and secure?

Absolutely. All text file processing happens locally in your web browser using JavaScript. Your files never touch our servers or get uploaded to the internet for these file types. Complex documents (PDFs, DOCX, XLSX, PPTX) are processed server-side for text extraction. They're handled in-memory during the request and never stored or persisted. We don't log, store, or analyze your files.

Can you see my files?

No. For text files, processing is 100% browser-based - we literally cannot see them because they never reach our servers. For PDFs and Office documents, they're processed via our server-side API for text extraction. They're handled in-memory and never stored. We don't log file names, contents, or any metadata.

Is the code open source?

Yes! OneFile is fully open source under the MIT license. You can view all the code on GitHub (github.com/wahibonae/onefile), verify exactly how we handle files, report bugs, contribute improvements, or even host your own private version.

Do you store uploaded files?

No, never. Text files are processed entirely in your browser and never sent to us. Documents sent for text extraction are processed in-memory during the API request and automatically discarded when processing completes - they're never written to disk or stored in any database.

Technical Questions

What is .gitignore support?

If your uploaded folder contains a .gitignore file, OneFile automatically reads it and excludes any files matching those patterns. This is incredibly useful for developers - when you upload a code project, we'll automatically skip node_modules, .env files, build artifacts, and anything else in your .gitignore.

Does OneFile work on mobile devices?

Yes! OneFile is fully responsive and works on smartphones and tablets (iOS and Android). However, for the best experience with large folder uploads (especially drag-and-drop), we recommend using a desktop or laptop browser. Mobile file selection may be limited by your device's operating system.

What browsers are supported?

OneFile works on all modern browsers including Chrome, Firefox, Safari, Edge, and Brave. We recommend using the latest version of any major browser for the best experience. Internet Explorer is not supported.

Can I edit the combined output before downloading?

The preview area is read-only to ensure accuracy, but after copying to clipboard or downloading the file, you can edit it in any text editor (Notepad, VS Code, etc.) before uploading to your AI platform.

Troubleshooting

Why are some of my files being skipped?

Files are skipped for several reasons: 1) They're in your .gitignore file, 2) They're in ignored directories (node_modules, .git, dist, build, etc.), 3) They're unsupported file types (images, videos, binaries), 4) They're empty, or 5) They failed to process. Check the toast notifications for details on what was skipped and why.

The upload is taking a long time. Is something wrong?

Large folders with thousands of files or large PDFs can take 10-30 seconds to process. You'll see a loading indicator while processing. If it's stuck for more than a minute, try refreshing and uploading fewer files at once. Complex documents (PDFs, XLSX) take longer because they require server-side processing.

I got an error while uploading. What should I do?

Common solutions: 1) Check your internet connection (needed for PDF/DOCX processing), 2) Try uploading fewer files at once, 3) Remove any corrupted files, 4) Refresh the page and try again, 5) Check if specific file types are causing issues. If problems persist, please open an issue on our GitHub repository with details.

Can I combine files that are already combined?

Yes, but it's not recommended. You can upload a previously generated OneFile output and combine it with new files, but you'll end up with duplicate file path markers. It's better to re-upload all original files together for a clean output.

Use Cases

How do students use OneFile?

Students use OneFile to combine research papers, course materials, lecture notes, and assignments into one file for analysis by AI. This is especially helpful for thesis research, essay writing with multiple sources, or studying with AI tutors. Upload all your materials once and ask questions about any part of them.

How do developers use OneFile?

Developers use OneFile to share entire codebases with AI for code review, debugging help, or documentation generation. Instead of copying and pasting individual files, upload your whole project folder (respecting .gitignore) and get AI assistance on the full codebase context.

Can I use this for professional/business documents?

Yes! Professionals use OneFile to combine meeting notes, reports, spreadsheets, presentations, and documentation for AI analysis. Perfect for preparing board meeting materials, quarterly reports, or project documentation. Remember that your data stays private.

Still Have Questions?

Can't find the answer you're looking for? Check out our other resources or reach out to the community.

Ready to Try OneFile?

Combine unlimited files and bypass AI upload limits in seconds.