Help center

PromptParle frequently asked questions

Direct answers about what PromptParle is, how open signup works (it's free), the desktop client, where to put BYOK provider keys (on your PC), privacy, and savings expectations.

What is PromptParle?

PromptParle is an AI context optimization gateway that sits between your desktop tools and providers such as OpenAI, Claude, Gemini, and Grok. It strips bloated tokens, keeps the useful signal, and routes live prompts so you can use flagship models at a lower effective cost. You keep your model choice. Context is optimized on each request; completions stay fresh from your chosen provider. Savings come from less bloat, not a silent quality trade-off. PromptParle is free and open to sign up. Chat runs in a free local desktop client on your PC; the portal handles your account, plan, and desktop license keys (pp_live_). Provider API keys are set on the PC. Create a free account at https://promptparle.com/register.

  • Access: free, open signup
  • Chat: desktop client only (not a portal chat tab)
  • Keys: model keys on the PC; portal only hashes desktop license keys
  • Savings: less context waste, same models, live completions

60 questions across 7 topics. Jump to: Product · Access & accounts · Keys & billing · Desktop client · Privacy & security · Usage & results · Support.

Showing 60 of 60 questions.

Product

What is PromptParle?

PromptParle is an AI context optimization gateway. It sits between your desktop tools and providers like OpenAI, Claude, Gemini, and Grok. It thins noisy context, keeps the useful signal, helps mask secrets, and routes cleaner prompts so you pay for less filler.

What problem does it solve?

Large logs, docs, and code dumps burn tokens and bury the ask. Users hit plan limits mid-work. AI vendors bill on volume, they are not built to shrink your spend. PromptParle sends leaner, higher-signal context while you keep the models and accounts you already pay for.

How does PromptParle save money?

You choose OpenAI, Claude, Gemini, or Grok models your key allows. PromptParle reduces bloated context so flagship models cost less per useful turn. Completions stay live from your provider every request.

I already use agents and local workflows. Why still use this?

Agents and multi-step local workflows can spread work, but every hop can still ship a fat context window. PromptParle optimizes the shared problem underneath: tokens that should never have hit the meter.

Can this help when I hit provider plan limits?

Often yes. Many free and mid-tier plans cut you off with “you’ve reached your max.” Stripping bloated tokens means fewer tokens per request, which can delay that wall or stop it for some workloads. Results depend on how noisy your context was.

Why don’t AI companies just optimize my token spend?

Tokens are their revenue model. Larger context windows and heavy usage grow that business. PromptParle exists for the buyer side: keep the model quality you need, pay for less noise.

Is PromptParle a chat app or a model?

Neither. It is not its own foundation model. Chat runs in the free desktop client on your machine. Models are provided by the AI vendors you configure with your own API keys.

What is the difference between the portal and the desktop client?

The portal handles invitations, plan, and desktop license keys (pp_live_…), plus optional usage stats. Day-to-day chat, optimize, provider keys, workspace, Git, and SSH run in the local desktop client (pp) on your PC.

What is the compression dial?

A 1-5 control that trades fidelity for token savings: 1 Max Fidelity, 2 High Fidelity, 3 Optimized, 4 High Savings, 5 Max Savings. Lower numbers keep more of the original text; higher numbers aim for more reduction on noisy material. Typical bands: ~0-10% at dial 1 up to ~50-80% at dial 5 on noisy packs. Unique prose may show little or no reduction.

What are optimization profiles?

Job-oriented presets such as general, developer, security-review, log-analysis, documentation, and executive-summary. They bias what kinds of content to prefer keeping. They are not a guarantee of a fixed savings percentage.

Which AI providers are supported?

OpenAI, Anthropic (Claude), Google Gemini, and xAI Grok when you supply a valid provider API key. Availability of specific models depends on your provider account and key permissions.

Do you train models on my prompts?

PromptParle is not a foundation-model trainer. Whether a third-party provider trains on API traffic is governed by that provider’s terms and your agreement with them. Use their enterprise/API settings if you need stricter data handling.

Access & accounts

How do I sign up?

Registration is open and free. Create an account at https://promptparle.com/register with email (a quick verification link) or Google/GitHub. Then create a desktop license key (pp_live_) for each machine you install on.

Is there an invitation or waitlist?

No. Signup is open to everyone, no invitation required. You can still invite a friend from the portal as a nicety, but it is optional.

How much does it cost?

PromptParle is free. There is no paid tier and no paywall — the optimize + provider calls run on your own PC with your own keys, so there is nothing to bill. If it helps you, there is an optional pay-what-you-can way to support the project.

I have a code. What next?

Open Create account, enter the code, set your password for the invited email, sign in, create a desktop license key (pp_live_…), run the installer and paste that key, then set OpenAI/Claude/Gemini/Grok keys in the local UI (⋯ → Providers) or with Set-PromptParleProviderKey.

Can I sign in with Google or GitHub?

When those options are enabled for the deployment, yes; for accounts that already completed invitation onboarding. Invitation is still required to create access.

I forgot my password. What do I do?

Use Forgot password on the sign-in page. If email delivery is configured, you will get a time-limited reset link. OAuth-only accounts may not have a password until you set one in Settings.

Can I share one account across a whole team?

Plans can allow concurrent desktop seats, but sharing a single login is not a substitute for proper user accounts. Prefer one person per account for auditability and key hygiene.

Keys & billing

What is BYOK?

Bring Your Own Key. You store OpenAI, Claude, Gemini, or Grok API keys on your PC (desktop 0.25+). The desktop calls that provider directly; the provider bills your account for model usage. PromptParle does not hold those keys for day-to-day chat.

Where are provider keys stored?

On your machine only for desktop chat: local UI ⋯ → Providers, or Set-PromptParleProviderKey (DPAPI on Windows when available). They are not uploaded to PromptParle.

How do I enter or edit a model API key?

Run pp, open the local browser UI, then ⋯ menu → Providers. Choose the provider, paste the key, click Save on this PC. To change a key, paste the new one and save again. PowerShell: Set-PromptParleProviderKey -Provider openai -ApiKey '…'.

What is a desktop API Key?

A license key (starts with pp_live_) that proves this PC may use your PromptParle account. Create it under portal API Keys. The full value is shown once; the portal stores a hash. It is not an OpenAI/Claude key, set those on the PC separately.

Who pays for AI tokens?

You do, via your provider account (BYOK on the PC). PromptParle’s value is reducing how much noisy context you send. PromptParle itself is free; provider token invoices are entirely separate.

Does PromptParle mark up provider prices?

No. Provider usage is billed by the provider to your key. PromptParle is free and never sits on the token meter — there is no PromptParle fee and no hidden surcharge on any token from the model vendor.

Can I revoke a desktop key?

Yes. Revoke it in the portal under API Keys. The desktop client will stop authenticating with that key; create a new one if needed.

What is the API IP allowlist?

An optional list of IPs allowed to use your desktop API keys. Empty means unrestricted. Browser portal sessions are not gated by that list the same way desktop keys are.

How much does PromptParle cost?

$0. PromptParle is free for everyone — no paid tier, no paywall, no feature locks. Optimization and provider calls run on your own PC with your own keys (BYOK), so there is no server on the prompt path and nothing to charge for. AI provider tokens are always separate (BYOK). https://promptparle.com/pricing

Is there a paid plan or a way to support the project?

There is no paid plan; every feature is free. If PromptParle saves you tokens and you would like to help keep it maintained, there is an optional pay-what-you-can donation — chip in whatever it is worth to you, or nothing. No features are locked behind it. https://promptparle.com/pricing

Desktop client

What platforms are supported?

Windows (PowerShell 5.1 or PowerShell 7+) and Linux/macOS with PowerShell 7 (pwsh) and git. The local UI runs in your browser against a server bound to 127.0.0.1 on your machine.

How do I install on Windows?

Open the Install page and run the Windows command (irm …/install.ps1 | iex). That bootstrap clones the project from GitHub, validates your invitation code, installs the module, and asks for your pp_live_ key.

How do I install on Linux or macOS?

Install git and PowerShell 7, then open the Install page and run the Linux/macOS command (curl …/install.sh | bash). Same GitHub-based flow as Windows after the bootstrap download from this site.

How do I start local chat?

After install, open PowerShell and run pp. That starts the local server and opens the browser UI at http://127.0.0.1. Leave the PowerShell window open while you chat. For terminal-only chat: Start-PromptParle -Cli. Stop with the UI control or Stop-PromptParleLocalServer.

Where does the desktop store its config?

Under your user profile (for example ~/.promptparle/config.json on Unix, or %USERPROFILE%\.promptparle on Windows). That file holds the desktop license key, local provider keys (protected), and preferences. On Windows, DPAPI is used when available.

Do SSH, Git, and workspace credentials leave my PC?

No. Remote access and repo credentials stay on your machine. They are not uploaded to PromptParle as part of normal SSH/Git/workspace use.

What about secret masking?

On desktop 0.25+, a secret gate runs on your PC before any model call (mask credential-shaped patterns; strict policy can block residual high-confidence secrets). No scanner is perfect, still avoid pasting production secrets when you can.

Does “local-first” mean my prompts never leave my PC?

Prompt and context stay on your PC for optimize. Model calls go from your PC directly to OpenAI/Claude/Gemini/Grok with your local provider key. The PromptParle portal is for license and account, not on the model path. Details: https://promptparle.com/trust

How do updates work?

The local UI can check for client updates and apply a portal-published package. You can also re-run the installer or use the module’s update command. After updating, hard-refresh the browser tab.

Can I use it offline?

Yes for local work: the UI, dial optimize, and tools that only touch your machine run on your PC without sending prompts to PromptParle. Model calls need network access to your AI provider. Occasional license checks may contact PromptParle.

Privacy & security

What data does the portal store?

Account profile, hashed desktop keys, usage stats, and session titles. Prompt and context text are not stored in the cloud (stats-only product policy). Provider keys for desktop chat live on your PC, not in the portal.

Do you store my prompts or context?

No. Usage history is token stats and session titles only. Prompt and context bodies are not captured or retained in the portal.

Is traffic encrypted in transit?

The public site is served over HTTPS. Your connection to AI providers also uses those providers’ HTTPS APIs.

Who can see my invitation requests?

Operators who manage invitations for the deployment. Do not put secrets in the optional note field on the request form.

Is the product open source?

Client and portal source may be published under the project’s repository and license terms. That does not mean every internal system, process, or partner integration is public. Check the repository LICENSE and SECURITY docs for the authoritative statement.

Does my prompt go through PromptParle servers?

No on desktop client 0.25+. Optimize and the model call run on your PC; the provider is called directly with a local key. The portal handles account, plan, and the pp_live_ desktop key. https://promptparle.com/trust

Where are my AI provider keys stored?

On your PC only (DPAPI on Windows when available). Set-PromptParleProviderKey or Providers in the local UI. They are never uploaded to PromptParle. The separate pp_live_ desktop key is only for license/entitlements.

What does the portal see?

Account, plan, hashed desktop keys, invitations. Not your prompt/context bodies and not your OpenAI/Claude/Gemini/Grok keys (local-first 0.25+).

Who should not use PromptParle?

Anyone who cannot send optimized context to their chosen AI provider (that path still exists, it is the model). If you need fully air-gapped inference with no external model at all, this product is not that. For hop/key-custody concerns vs PromptParle itself: local-first removes PromptParle from that path.

Usage & results

When are savings high vs near-zero?

Often high: noisy logs, duplicated frames, fat security packs, multi-file dumps, agent chains that re-ship the same context. Often near-zero: short unique questions and already-tight prose, there is little honest bloat to remove. That is correct behavior, not a failure. See https://promptparle.com/examples

Why do I sometimes see 0% reduction?

Short prompts and already-compact unique text often cannot shrink further without losing meaning. Clean prose is already signal. Savings show up more on noisy logs, duplicates, and filler-heavy packs.

Are savings guarantees?

No. “Keep the signal” is the goal, not a fixed percent. We are still measuring real workloads; published example packs (Noisy ~78%, Security ~60%, Clean ~2%) show the shape of results so far. Proof today is the dial savings line in the desktop UI per turn.

What do you actually optimize (heuristics)?

Open categories include: repetition/near-duplicates, boilerplate, structure-over-bulk, profile bias (security/log/dev/etc.), dial 1-5 fidelity tradeoff, and secret masking. We do not publish the full scoring IP. See https://promptparle.com/trust

Where do I see savings?

In the desktop client’s savings views (per turn) and optionally in the portal Usage page (token stats and session titles). Full prompt text is not stored in the cloud.

Does Optimize-only still call the model?

Optimize-only paths are meant to compress and report savings without a full provider completion. Full chat/completions still call your configured model.

Support

Install fails on invitation code. Why?

Common causes: code not yet accepted on the portal, typo, already redeemed, or expired. Finish the email/portal form first, then re-run the installer with the same code.

Desktop says unauthorized. Why?

Usually a revoked, incomplete, or wrong pp_live_ key, or an IP allowlist that does not include your current address. Create a new key and check Settings → API IP allowlist.

Local UI will not open.

Confirm the PowerShell window is still running, the port is free, and you are browsing http://127.0.0.1 (not a remote host). Try Stop-PromptParleLocalServer then pp again.

How do I uninstall?

Use Uninstall-PromptParle from the module or the uninstall script in the repo. Optional flags can remove local config and the git clone.

How do I get help?

Start with the desktop Help panel and the GitHub README. For account or invitation issues, reply to onboarding email or contact the operator who invited you.

Can I use PromptParle for regulated or classified work?

Only under your organization’s policies. You must validate provider terms, data residency, logging settings, and network controls yourself. PromptParle does not replace your compliance program.

Related pages

This FAQ is product-facing. It does not document proprietary implementation details. For regulated work, validate provider terms and your own compliance requirements.

Contact us