Frequently Asked Questions

60 questions & answers about FrameTrain

No answer found? Open a GitHub issue or ask on Discord.

General

9 questions

FrameTrain is a desktop app for local machine learning training. You can use it to fine-tune HuggingFace models with LoRA and QLoRA on your own datasets – no cloud, no dependencies, running entirely on your own hardware.

Since version 1.2.46 you land on the home screen after signing in – an overview of where your project stands: running trainings with progress, what finished or failed since your last visit, key figures for models, versions, datasets and trainings, the most recent runs, the loss trend and your best test results. A hint panel flags what needs attention, using plain rules rather than AI. From there every card leads into the matching area, and the home button at the top left of the sidebar brings you back at any time. Before that, the app opened straight into the model list.

The AI features are optional and off by default. Once enabled, an AI coach helps on every page, and there is a code assistant for your own scripts in Dev Train and Dev Test, a metrics assistant in training, the AI training analysis, Synapse Magic in the Synapse Builder and the AI briefing on the home screen. You choose Claude, OpenAI or Groq with your own API key – each provider keeps its own key, stored securely in your system keychain – or Ollama, fully local and without a key. FrameTrain charges nothing extra for this: any cost comes from the provider you pick, and the token budget from Minimal to Unlimited sets how detailed and thorough all AI features are.

Since version 1.2.58, typing / in the coach's input field opens a list of prepared questions for the current page – for example /ram on the training page (“Will this run fit on my machine?”), /assess in the analysis or /review in Dev Train. /here and /next are available everywhere. Pick one with the arrow keys and Enter, with Tab or by clicking. Skills cost no extra tokens; they just ask the question more precisely.

ML engineers, data scientists, researchers, and developers who want to train AI models locally and in a GDPR-compliant way. Even without deep ML knowledge you can get started with FrameTrain.

FrameTrain runs on Windows 10/11, macOS 11+ on Apple Silicon (M1/M2/M3/M4), and Ubuntu 20.04+. All common Linux distributions with AppImage support work as well. Intel Macs are not supported, because the PyTorch stack no longer ships the required versions for Intel Macs. On every platform you also need Python 3.8 or newer – the app will not start without it.

Only at startup for license validation via API key. Training itself runs completely offline. Models from HuggingFace are downloaded once and stored locally.

Yes. FrameTrain is deliberately built so that company data never leaves your own infrastructure. There is no automatic telemetry and no cloud uploads during training – your training data, datasets, and model weights never leave your machine. You can optionally enable error reporting in the settings, which sends anonymized diagnostic data (e.g. stack trace, app version) if a crash occurs – off by default and can be disabled at any time. Ideal for GDPR-compliant ML projects.

There is no open self-service trial, but there are voucher codes: a free-months code lets you use FrameTrain in full at no cost – either with no payment method at all (access then ends automatically) or with a card on file for a seamless continuation. There are also discount codes and lifetime codes. Redeem any code at /redeem. We hand out codes through promotions and partners – just email us. Without a code, the Early Access price starts at €4.99/month, cancellable monthly.

Still have questions?

If you didn't find an answer to your question, feel free to open a GitHub issue or start a community discussion.