User Guide

1. AI Provider Setup

Uprika uses AI to generate listings, brainstorm keywords, translate content, and create screenshot templates. You bring your own AI provider — Uprika supports any OpenAI-compatible API.

Ollama — Free, Local AI

Ollama runs AI models entirely on your machine. No API key, no cloud, no cost. Best for users who want full privacy or don't want to pay for API calls.

Step 1: Install Ollama

1. Go to ollama.com and download the installer for your OS.
2. Install and launch Ollama. It runs as a background service.

Step 2: Pull a Model

Open your terminal and pull a recommended model:

# Recommended for ASO (good quality, fast)
ollama pull gemma3:12b

# Lightweight alternative (faster, less quality)
ollama pull gemma3:4b

# Premium quality (needs 16GB+ RAM)
ollama pull qwen3:14b

Step 3: Configure in Uprika

1. Open Uprika → Settings
2. Under AI Provider, select Ollama
3. API Base URL: http://localhost:11434/v1 (default, no change needed)
4. Model Name: enter the model you pulled (e.g. gemma3:12b)
5. API Key: leave empty (Ollama doesn't need one)
6. Click Test AI to verify the connection

Replicate — Cloud AI Without API Key Concerns

Replicate gives you access to thousands of open-source models (Llama, Mistral, etc.) with a simple pay-per-use pricing — no monthly commitments, you only pay for what you use.

Step 1: Create Account

1. Go to replicate.com and sign up.
2. New accounts get free credits to start.

Step 2: Get Your API Token

1. Go to Account → API Tokens
2. Click Create Token
3. Copy the token (starts with r8_)

Step 3: Configure in Uprika

1. Open Uprika → Settings
2. Under AI Provider, select Custom / OpenAI-compatible
3. API Base URL: https://openai.replicate.com/v1
4. API Key: paste your Replicate token
5. Model Name: meta/llama-4-scout-instruct (or any model from their catalog)
6. Click Test AI to verify

Other Providers

Uprika works with any OpenAI-compatible API. Here are quick links for popular providers:

For all providers: go to Settings → AI Provider, enter the API Base URL, API Key, and Model Name, then click Test AI.

2. Store Credentials

To publish listings directly to the App Store or Google Play from Uprika, you need to set up API credentials. Credentials are stored in your OS secure keychain — never sent to any server.

Google Play Store

Step 1: Create a Google Cloud Project

1. Go to Google Cloud Console
2. Create a new project (e.g. uprika-play-api)

Step 2: Enable the Google Play Android Developer API

1. In your project, go to APIs & Services → Library
2. Search for Google Play Android Developer API
3. Click Enable

Step 3: Create a Service Account & Download JSON Key

1. Go to APIs & Services → Credentials
2. Click + Create Credentials → Service Account
3. Name it (e.g. uprika-play-access), click Create
4. On the Credentials page, click the service account email to open details
5. Go to Keys tab → Add Key → Create new key → JSON
6. The JSON key file downloads automatically — keep it safe

Step 4: Grant Permissions in Google Play Console

1. Go to Google Play Console
2. Navigate to Users and permissions
3. Click Invite new users
4. Paste the service account email (from the JSON key's client_email field)
5. Grant these permissions:
   • View app information and download bulk reports
   • Create, edit, and delete draft apps
   • Manage store presence
6. Click Invite user

Step 5: Import into Uprika

1. Open Uprika → Settings → Store Credentials
2. Under Google Play Store, click Upload JSON Key
3. Select the JSON file you downloaded

Apple App Store

Step 1: Generate an API Key

1. Go to App Store Connect
2. Navigate to Users and Access → Integrations → App Store Connect API
3. Click + to generate a new key
4. Name: Uprika ASO Access
5. Role: App Manager (recommended — minimum permission needed)
6. Click Generate

Step 2: Download the .p8 Key File

1. Click Download API Key next to the new key
2. Save the .p8 file securely

Step 3: Note Your Key ID & Issuer ID

• Key ID — shown next to your key name (e.g. ABC1234DEF)
• Issuer ID — shown at the top of the API page (a UUID)

Step 4: Import into Uprika

1. Open Uprika → Settings → Store Credentials
2. Under Apple App Store, enter:
   • Issuer ID
   • Key ID
   • API Key File — upload your .p8 file

3. Getting Started

When you open Uprika for the first time, an onboarding screen will guide you to set up your AI provider (Ollama for local AI, or configure a cloud provider in Settings). Once that's done, here's the typical workflow:

1

Run a Keyword Scan

From the Research page, enter your app idea and select target languages. Uprika scrapes both the App Store and Google Play to find keyword opportunities, then scores them using AI.

2

Create a Listing

From the scan results, create an AI-generated listing. Uprika generates title, subtitle, description, keywords, and promotional text — all optimized for the keywords found in your scan.

3

Build Screenshots

Use the Screenshot Builder to create app store screenshots from 86+ ready-made templates. Customize text, images, colors, and export at all required device sizes.

Each image element supports Responsive Images — upload different images per device size (iPhone 5.5", 6.1", 6.5", iPad, Android). Sizes without a custom image automatically use the default. This ensures your screenshots look perfect on every device listed in the App Store and Google Play.

4

Expand to Markets

From any listing, expand to new languages with one click. AI translates and optimizes the listing for each market. Screenshot text is translated automatically.

5

Publish

Click Publish to push your listing text and screenshots directly to the App Store or Google Play. Select which languages to include — all published in one go.

4. Keyword Gap Analysis

The Keyword Gap tool helps you find keywords that your competitors rank for but you don't. It's available in the Keywords tab of any listing.

How it works

1. Open a listing and switch to the Keyword Analysis tab
2. Uprika compares your listing's target keywords against competitor apps from your scan data
3. Keywords are shown in a table with columns: keyword, your rank, competitor rank, and opportunity score
4. Select missing keywords and click Add to Target to include them in your listing

Tip: After adding gap keywords, click Regenerate All to have AI rewrite your listing with the new keywords incorporated naturally.

5. CLI / Automation

Uprika includes a CLI for automating ASO workflows. The CLI is the same binary as the app — when you pass a command, it runs in terminal mode.

Setup

• macOS: Open Uprika → Settings → CLI / Agent Access → click Install. This creates a symlink so uprika works from any terminal.
• Windows: The installer adds Uprika to your PATH automatically.
• Linux (deb): Already in PATH at /usr/bin/uprika.

Example Commands

# Run a keyword scan
uprika scan --idea "fitness tracker" --langs "en,ja,de"

# Create a listing with AI
uprika create-listing --app-idea "meal planning app" --store "app_store"

# Publish all languages to the store
uprika publish --listing-id 123

# Export screenshots
uprika get-listing --id 1 --export-screenshots ./output/

For TOTP authentication setup and full command reference, see Settings → CLI / Agent Access in the app.