Connectors

Connectors

Connectors let you extend Aiffinity in two directions:

All data source connectors request read-only access. Aiffinity cannot modify, delete, or post to any connected service. You can disconnect at any time.

How Soul Sharing Works

Soul Sharing lets you bring your personality to any AI tool. Instead of starting from scratch with every new app, your Soul provides instant context — your communication style, preferences, values, and tone — so the AI feels like it already knows you.

Your Personal Soul Token

Every outbound connector uses your Personal Soul Token — a secure API key that grants read-only access to your Soul data. To get your token:

  1. Open Settings > Connected Apps in the Aiffinity app.
  2. Your Personal Soul Token is shown at the top of the page.
  3. Copy it and paste it into the external service.

Your Soul Token is like a password — keep it private. Anyone with your token can read your Soul data. You can regenerate it at any time from Settings, which instantly revokes the old token.

Soul API Endpoints

Different connectors use different endpoints depending on what data they need:

EndpointWhat It ReturnsBest For
/v1/soul/prompt LLM-ready prompt pack with your style guide, preferences, and communication patterns AI assistants, chatbots, writing tools
/v1/soul/snapshot Structured personality data with dimension scores and trait analysis Automation workflows, data pipelines, agent frameworks
/v1/soul/capsule Brief summary of who you are with interaction hints Quick context, lightweight integrations

Scopes

Each connector requests specific scopes that control what Soul data it can access:

AI Assistants

Personalize your favourite AI assistants with your Soul. Each assistant receives your communication style and preferences so its responses feel tailored to you.

ChatGPT

Personalize ChatGPT with your communication style and preferences. Works with any Custom GPT you create or use.

What It Does

How to Connect

  1. Copy your Personal Soul Token from the Connectors page in the Aiffinity app.
  2. In ChatGPT, create or edit a Custom GPT.
  3. Go to Configure → Actions → Create new action.
  4. Set Authentication to API Key, header Authorization, prefix Bearer .
  5. Import the OpenAPI spec from https://soul-api.aiffinity.me/openapi.json.
  6. Test the action — ChatGPT will now know your style.

Privacy

Your Soul data will be sent to OpenAI's servers when ChatGPT fetches your profile. Only data matching the requested scopes is shared. Revoke your token at any time to stop sharing.

Google Gemini

Personalize Gemini responses with your communication style. Works with Google AI Studio and custom apps.

What It Does

How to Connect

  1. Copy your Personal Soul Token from the Connectors page.
  2. In your Gemini integration, fetch your Soul prompt pack from the API.
  3. Use the returned style_guide as Gemini's system prompt.
  4. Include the preferences object to further customize behaviour.

Privacy

Your Soul data will be sent to Google's servers. Review Google's privacy policy. Revoke your token at any time.

Claude

Share your style guide with Claude for personalized conversations. Use in Claude Projects or API integrations.

What It Does

How to Connect

  1. Copy your Personal Soul Token from the Connectors page.
  2. In your Claude integration, fetch the Soul prompt pack before conversations.
  3. Include the style_guide in Claude's system prompt.
  4. Use the preferences object to customize behaviour.

Privacy

Your Soul data will be sent to Anthropic's servers. Only use with trusted applications. Revoke your token at any time.

Microsoft Copilot

Personalize Copilot Studio skills with your Soul. Works with enterprise Copilot deployments.

What It Does

How to Connect

  1. Copy your Personal Soul Token from the Connectors page.
  2. In Copilot Studio, create a new plugin or skill.
  3. Add an HTTP action to fetch your Soul prompt pack from the API.
  4. Use the returned data to customize Copilot's responses.

Privacy

Your Soul data will be processed by Microsoft. Review your organization's data policies.

Perplexity

Tailor Perplexity search answers to your communication style and preferences.

What It Does

How to Connect

  1. Copy your Personal Soul Token from the Connectors page.
  2. In Perplexity, go to your profile settings.
  3. Paste your Soul Prompt Pack into "Custom Instructions".
  4. Perplexity will use your style preferences in all responses.

Privacy

Your Soul data will be sent to Perplexity's servers. Review their privacy policy.

Grok

Personalize Grok conversations with your communication style. Use on X or the standalone Grok app.

What It Does

How to Connect

  1. Copy your Personal Soul Token from the Connectors page.
  2. Use your Soul Prompt Pack as custom instructions when chatting with Grok.
  3. On X or the Grok app, paste into your personalization settings.

Privacy

Your Soul data will be sent to xAI's servers. Review their privacy policy.

DeepSeek

Share your style with DeepSeek for personalized AI assistance in chat and code.

What It Does

How to Connect

  1. Copy your Personal Soul Token from the Connectors page.
  2. Paste your Soul Prompt Pack as a system prompt in DeepSeek Chat.
  3. Or use the token with the DeepSeek API for programmatic access.

Privacy

Your Soul data will be sent to DeepSeek's servers. Review their privacy policy.

Automation & Agents

Bring personality context to your workflows and AI agents. These connectors let you fetch your Soul data via REST API and use it in any automation pipeline.

Zapier

Fetch your personality data in Zap workflows. Add Soul context to any automated workflow.

What It Does

How to Connect

  1. Copy your Personal Soul Token from the Connectors page.
  2. In Zapier, add a "Webhooks by Zapier" action.
  3. Choose "Custom Request" or "GET".
  4. URL: https://soul-api.aiffinity.me/v1/soul/snapshot
  5. Add Header: Authorization: Bearer YOUR_TOKEN
  6. Use the returned data in subsequent Zap steps.

Privacy

Your Soul data will pass through Zapier's servers. Use secure connections only.

Make

Pull your Soul data into Make scenarios. Enrich automations with personality context.

What It Does

How to Connect

  1. Copy your Personal Soul Token from the Connectors page.
  2. In Make, add an HTTP module to your scenario.
  3. Configure a GET request to https://soul-api.aiffinity.me/v1/soul/snapshot.
  4. Add the Authorization header with your Bearer token.
  5. Parse the JSON response and use in subsequent modules.

Privacy

Your Soul data will be processed by Make's infrastructure.

n8n

Integrate Soul data into self-hosted workflows. Full control over your data in your own infrastructure.

What It Does

How to Connect

  1. Copy your Personal Soul Token from the Connectors page.
  2. In n8n, add an HTTP Request node.
  3. Method: GET
  4. URL: https://soul-api.aiffinity.me/v1/soul/snapshot
  5. Authentication: Generic Credential Type → Header Auth
  6. Header Name: Authorization, Value: Bearer YOUR_TOKEN

Privacy

Your Soul data will be processed by your n8n instance. Secure your deployment appropriately.

LangChain

Build LangChain applications with Soul-aware context. Use as a custom tool in RAG pipelines.

What It Does

How to Connect

  1. Copy your Personal Soul Token from the Connectors page.
  2. Create a custom LangChain tool that fetches Soul data from the API.
  3. Use the snapshot for context in RAG pipelines.
  4. Use the prompt pack for system prompt customization.

Privacy

Your Soul data will be used in your LangChain application. Ensure proper data handling in your deployment.

Agent Frameworks

Give personality context to AI agents built with AutoGen, CrewAI, and other multi-agent frameworks.

What It Does

How to Connect

  1. Copy your Personal Soul Token from the Connectors page.
  2. In your agent framework, create an HTTP tool that fetches Soul data.
  3. Use the snapshot to provide personality context to agents.
  4. Use the prompt pack for system prompt customization.

Privacy

The agent framework will access your Soul data. Ensure proper data handling in your deployment.

OpenClaw

Connect your autonomous AI agent to your Soul for personalized task execution. Works with Claude, GPT, and local models via Ollama.

What It Does

How to Connect

  1. Install OpenClaw: npm install -g openclaw@latest
  2. Run openclaw onboard --install-daemon
  3. Copy your Personal Soul Token from the Connectors page.
  4. Add AIFFINITY_SOUL_TOKEN to your OpenClaw config.

Privacy

OpenClaw runs locally on your machine with full system access. Your Soul data stays on your device. This connector is bidirectional — interaction patterns flow back to enrich your Soul.

Custom API

Connect any application via the Soul REST API. Full documentation and ETag caching support.

What It Does

How to Connect

  1. Copy your Personal Soul Token from the Connectors page.
  2. Choose the endpoint that fits your use case:
    • /v1/soul/snapshot — Structured personality data
    • /v1/soul/prompt — LLM-ready prompt customization
    • /v1/soul/capsule — Brief summary with interaction hints
  3. Make HTTP GET requests with your Bearer token in the Authorization header.
  4. Use the ETag / If-None-Match headers to avoid unnecessary re-fetches.

Privacy

Your Soul data will be sent to the receiving application. Only use with trusted services. Revoke your token at any time to stop all sharing.

Meta AI

Personalize Meta AI across WhatsApp, Instagram, and Messenger with your Soul.

What It Does

How to Connect

  1. Copy your Personal Soul Token from the Connectors page.
  2. Use the Soul API to fetch your personality context.
  3. Inject the context into Meta AI prompts or integrations.

Privacy

Your Soul data is shared read-only via your personal token. Revoke the token at any time to stop sharing.

Work & Productivity

Bring your personality to the tools you use every day. These connectors customize AI-powered writing, coding, and collaboration features with your style.

Notion

Personalize Notion AI with your writing style and personality.

What It Does

How to Connect

  1. Use with Notion's API or custom integrations.
  2. Fetch your Soul prompt pack to customize AI writing assistance.
  3. Include style preferences in your Notion automation scripts.

Privacy

Your Soul data may be sent to Notion's AI services for writing personalization.

Slack

Customize Slack bot responses with your communication style.

What It Does

How to Connect

  1. In your Slack bot backend, fetch the Soul prompt pack using your token.
  2. Use the style_guide to customize bot responses.
  3. Include preferences for tone and communication style.

Privacy

Your Soul data will be used in Slack conversations via your bot.

Discord

Personalize Discord bots with your communication style.

What It Does

How to Connect

  1. Copy your Personal Soul Token from the Connectors page.
  2. In your Discord bot, fetch the Soul prompt pack on startup.
  3. Use the style_guide to customize bot response tone.

Privacy

The Discord bot will use your personalization data. Review the bot's privacy policy.

Jira / Confluence

Personalize Atlassian AI features with your Soul.

What It Does

How to Connect

  1. Use with Atlassian Forge apps or custom integrations.
  2. Fetch Soul data to customize AI writing suggestions.
  3. Apply style preferences to generated content.

Privacy

Your Soul data may be processed by Atlassian's AI services.

Linear

Tailor Linear AI to your communication style.

What It Does

How to Connect

  1. Use with Linear's API or integrations.
  2. Fetch Soul data for personalized issue descriptions.
  3. Apply communication style to generated content.

Privacy

Your Soul data may be used in Linear's AI features.

Obsidian

Power Obsidian AI plugins with your writing style.

What It Does

How to Connect

  1. Copy your Personal Soul Token from the Connectors page.
  2. Use your Soul Prompt Pack with Obsidian AI plugins (e.g., Smart Connections, Copilot).
  3. Paste as a system prompt in the plugin settings.

Privacy

The Obsidian plugin may process your data locally or via cloud. Check the plugin's policy.

Raycast

Personalize Raycast AI commands with your communication style.

What It Does

How to Connect

  1. Copy your Personal Soul Token from the Connectors page.
  2. In Raycast, go to Settings > AI.
  3. Paste your Soul Prompt Pack into "Custom Instructions".

Privacy

Raycast may store your personalization data. Review their privacy policy.

GitHub Copilot

Adapt GitHub Copilot to your coding communication style.

What It Does

How to Connect

  1. Copy your Personal Soul Token from the Connectors page.
  2. Add your Soul Prompt Pack to .github/copilot-instructions.md in your repo.
  3. Or paste into GitHub Copilot settings under personalization.

Privacy

GitHub may store your personalization data. Review their privacy policy.

Cursor AI

Personalize Cursor AI editor responses with your style.

What It Does

How to Connect

  1. Copy your Personal Soul Token from the Connectors page.
  2. Add your Soul Prompt Pack to your .cursorrules file.
  3. Or paste into Cursor Settings > Rules for AI.

Privacy

Cursor may store your personalization data. Review their privacy policy.

Voice & OS Assistants

Bring your Soul to voice assistants and OS-level AI features.

Apple Siri / Apple Intelligence

Personalize Siri and Apple Intelligence with your Soul for context-aware responses.

What It Does

How to Connect

  1. Copy your Personal Soul Token from the Connectors page.
  2. In Shortcuts, create a new shortcut with a "Get Contents of URL" action.
  3. Set the URL to your Soul API endpoint with the Bearer token.
  4. Use the returned personality context in downstream Siri actions.

Privacy

Your Soul data is shared read-only with Siri via your personal token. Revoke the token at any time to stop sharing.

Amazon Alexa

Share your Soul with Alexa Skills for personalized voice interactions.

What It Does

How to Connect

  1. Copy your Personal Soul Token from the Connectors page.
  2. In your Alexa Skill backend, call the Soul API with the Bearer token.
  3. Use the returned personality context to customize Alexa responses.

Privacy

Your Soul data is shared read-only with Alexa via your personal token. Revoke the token at any time to stop sharing.

Data Sources

Data sources pull information from your apps and services to enrich your AI Soul. Aiven analyses your activity patterns — what you listen to, how you exercise, how you communicate — and uses those signals to build a more accurate picture of your personality. This means better conversations, better recommendations, and a deeper understanding of who you are.

How Data Sources Work

  1. Open Settings > Connected Apps in the Aiffinity app.
  2. Choose a service and tap Connect.
  3. Sign in to the service and approve read-only access.
  4. Your data syncs automatically in the background.
  5. Aiven analyses the data and maps it to personality dimensions in your AI Soul.

To manage or disconnect any service, return to Settings > Connected Apps and tap the connected service.

Spotify

Your music taste is one of the strongest personality signals. Connecting Spotify lets Aiffinity understand your aesthetic preferences, energy levels, and openness to new experiences through your listening patterns.

What Data Is Accessed

Aiffinity requests read-only access to:

Aiffinity cannot play, pause, skip, or modify your Spotify account in any way.

How It Enriches Your AI Soul

Your listening data maps to personality dimensions:

How to Connect

  1. Open Settings > Connected Apps in the Aiffinity app.
  2. Find Spotify and tap Connect.
  3. Sign in to your Spotify account when prompted.
  4. Approve read-only access to your listening data.
  5. Your listening history begins syncing automatically.

Managing Your Connection

View your Spotify connection status in Settings > Connected Apps. You can see when data was last synced and your connected account name (your Spotify display name or username).

How to Disconnect

  1. Go to Settings > Connected Apps.
  2. Tap Spotify.
  3. Tap Disconnect.
  4. Optionally, also revoke access from spotify.com/account/apps.

Privacy

Your playlists, song titles, and listening history are analysed for personality signals and then discarded. Only the resulting personality dimension scores (numbers like "openness: 0.7") are stored in your Soul profile. Your actual music library is not permanently retained on Aiffinity servers.

Troubleshooting

Reddit

Your Reddit activity reveals your interests, how you engage with communities, and what content you find worth saving. Connecting Reddit helps Aiven understand the breadth and depth of your curiosity.

What Data Is Accessed

Aiffinity requests read-only access to:

Aiffinity cannot post, comment, vote, or modify your Reddit account. Private messages are never accessed.

How It Enriches Your AI Soul

How to Connect

  1. Open Settings > Connected Apps in the Aiffinity app.
  2. Find Reddit and tap Connect.
  3. Sign in to your Reddit account when prompted.
  4. Approve read-only access.
  5. Your Reddit activity begins syncing automatically.

Managing Your Connection

View your Reddit connection in Settings > Connected Apps. Your connected account shows as u/yourusername.

How to Disconnect

  1. Go to Settings > Connected Apps.
  2. Tap Reddit.
  3. Tap Disconnect.
  4. Optionally, revoke access from reddit.com/prefs/apps.

Privacy

Only public posts and comments are analysed. Private messages are never accessed. Subreddit names and engagement counts are used to calculate personality scores, then the raw data is discarded. Only the resulting dimension scores are stored.

Troubleshooting

X

Your posts and interactions on X reveal how you express yourself publicly — your communication style, social engagement, and how you interact with others.

What Data Is Accessed

Aiffinity requests read-only access to:

Aiffinity cannot post, like, repost, follow, or modify your X account. Direct messages are never accessed.

How It Enriches Your AI Soul

How to Connect

  1. Open Settings > Connected Apps in the Aiffinity app.
  2. Find X and tap Connect.
  3. Sign in to your X account when prompted.
  4. Approve read-only access to your posts and likes.
  5. Your post history begins syncing automatically.

Managing Your Connection

Your connected account shows as @yourusername in Settings > Connected Apps.

How to Disconnect

  1. Go to Settings > Connected Apps.
  2. Tap X.
  3. Tap Disconnect.
  4. Optionally, revoke access from X Settings > Security > Apps.

Privacy

Only public posts are analysed. Direct messages and private account content are never accessed. Post text is processed for personality patterns and then discarded. The connection uses PKCE (Proof Key for Code Exchange) for enhanced security — no client secret is stored on your device.

Troubleshooting

Bluesky

Bluesky is a decentralised social network built on the AT Protocol. Connecting Bluesky lets Aiffinity understand your social patterns, content curation, and values through your activity on the network.

What Data Is Accessed

Aiffinity accesses:

Aiffinity cannot post, like, follow, or modify your Bluesky account.

How It Enriches Your AI Soul

How to Connect

Bluesky uses credential-based linking (not OAuth). You need to create an app password:

  1. Go to bsky.app/settings/app-passwords and create a new app password.
  2. Open Settings > Connected Apps in the Aiffinity app.
  3. Find Bluesky and tap Connect.
  4. Enter your Bluesky handle (e.g. yourname.bsky.social) and the app password you just created.
  5. Your Bluesky data begins syncing automatically.

Use a dedicated app password for Aiffinity — never share your main account password. App passwords can be revoked individually without affecting your Bluesky account.

Managing Your Connection

Your connected account shows as your Bluesky handle in Settings > Connected Apps.

How to Disconnect

  1. Go to Settings > Connected Apps.
  2. Tap Bluesky.
  3. Tap Disconnect.
  4. Revoke the app password at bsky.app/settings/app-passwords.

Privacy

Bluesky is built on an open protocol — all data accessed is publicly available on the AT Protocol network. Your app password is stored encrypted and is used solely to authenticate API requests. Post content is processed for personality patterns and discarded.

Troubleshooting

Oura Ring

Your Oura Ring tracks sleep, stress, activity, and recovery. Connecting it gives Aiffinity deep insight into your wellness patterns, emotional resilience, and self-care habits.

What Data Is Accessed

Aiffinity requests read-only access to:

Aiffinity cannot modify any data in your Oura account.

How It Enriches Your AI Soul

How to Connect

  1. Open Settings > Connected Apps in the Aiffinity app.
  2. Find Oura Ring and tap Connect.
  3. Sign in to your Oura account when prompted.
  4. Approve read-only access to your health and wellness data.
  5. Your Oura data begins syncing automatically.

Managing Your Connection

Your connected account shows as your Oura email address in Settings > Connected Apps.

How to Disconnect

  1. Go to Settings > Connected Apps.
  2. Tap Oura Ring.
  3. Tap Disconnect.
  4. Optionally, revoke access from the Oura app or cloud.ouraring.com.

Privacy

Daily summary scores (sleep, readiness, stress) are synced — not raw sensor data. Biometric readings (heart rate, SpO2) are processed for wellness signals and discarded. Only personality dimension scores are stored. Raw health data is never permanently retained on Aiffinity servers.

Troubleshooting

Strava

Your Strava activity history reveals your fitness consistency, sport variety, and social exercise habits. Whether you run, cycle, swim, or hike, Aiffinity uses your activity patterns to understand your discipline and adventurousness.

What Data Is Accessed

Aiffinity requests read-only access to:

Aiffinity cannot create, edit, or delete activities, and does not access exact GPS routes.

How It Enriches Your AI Soul

How to Connect

  1. Open Settings > Connected Apps in the Aiffinity app.
  2. Find Strava and tap Connect.
  3. Sign in to your Strava account when prompted.
  4. Approve read-only access to your activities.
  5. Your activity data begins syncing automatically.

Managing Your Connection

Your connected account shows as your Strava name (e.g. "Alex Smith") in Settings > Connected Apps.

How to Disconnect

  1. Go to Settings > Connected Apps.
  2. Tap Strava.
  3. Tap Disconnect.
  4. Optionally, revoke access from strava.com/settings/apps.

Privacy

Activity summaries (type, duration, distance) are analysed. Exact GPS routes and location data are never stored on Aiffinity servers. Only personality dimension scores are retained.

Troubleshooting

Google Calendar

Your calendar reflects how you structure your time. Connecting Google Calendar lets Aiffinity understand your scheduling habits, routine consistency, and how busy you typically are.

What Data Is Accessed

Aiffinity requests read-only access to:

Aiffinity cannot create, edit, or delete calendar events. Attendee details and event descriptions are not stored.

How It Enriches Your AI Soul

How to Connect

  1. Open Settings > Connected Apps in the Aiffinity app.
  2. Find Google Calendar and tap Connect.
  3. Sign in to your Google account when prompted.
  4. Approve read-only access to your calendar.
  5. Your calendar data begins syncing automatically.

Managing Your Connection

Your connected account shows as your Google email address in Settings > Connected Apps.

How to Disconnect

  1. Go to Settings > Connected Apps.
  2. Tap Google Calendar.
  3. Tap Disconnect.
  4. Optionally, revoke access from myaccount.google.com/permissions.

Privacy

Event metadata (times, titles, recurring status) is processed for scheduling patterns. Full event details, attendee lists, and event descriptions are not stored. Only personality dimension scores are retained.

Troubleshooting

Google Drive

Your Google Drive reflects your productivity and working style. Connecting it lets Aiffinity understand how you create and organise digital content.

What Data Is Accessed

Aiffinity requests read-only access to:

Aiffinity cannot read the contents of your files, create, edit, or delete any files. Only file metadata (names and types) is accessed.

How It Enriches Your AI Soul

How to Connect

  1. Open Settings > Connected Apps in the Aiffinity app.
  2. Find Google Drive and tap Connect.
  3. Sign in to your Google account when prompted.
  4. Approve read-only access to your Drive files.
  5. Your file metadata begins syncing automatically.

Managing Your Connection

Your connected account shows as your Google email address in Settings > Connected Apps.

How to Disconnect

  1. Go to Settings > Connected Apps.
  2. Tap Google Drive.
  3. Tap Disconnect.
  4. Optionally, revoke access from myaccount.google.com/permissions.

Privacy

Only file metadata (names and types) is accessed — file contents are never read, downloaded, or stored. Only personality dimension scores are retained.

Troubleshooting

Google Contacts

Your contact list reflects the size of your social network. Connecting Google Contacts gives Aiffinity a sense of how many people you stay in touch with.

What Data Is Accessed

Aiffinity requests read-only access to:

Aiffinity cannot add, edit, or delete contacts. Phone numbers and email addresses of your contacts are not stored.

How It Enriches Your AI Soul

How to Connect

  1. Open Settings > Connected Apps in the Aiffinity app.
  2. Find Google Contacts and tap Connect.
  3. Sign in to your Google account when prompted.
  4. Approve read-only access to your contacts.
  5. Your contact data begins syncing automatically.

Managing Your Connection

Your connected account shows as your Google email address in Settings > Connected Apps.

How to Disconnect

  1. Go to Settings > Connected Apps.
  2. Tap Google Contacts.
  3. Tap Disconnect.
  4. Optionally, revoke access from myaccount.google.com/permissions.

Privacy

Contact names and labels are used to understand your social network structure. Individual contact details (phone numbers, emails) are never stored on Aiffinity servers. Only the total count and resulting personality scores are retained.

Troubleshooting

Microsoft Outlook

Connecting Microsoft Outlook gives Aiffinity a comprehensive view of your professional communication style, scheduling habits, social network, and task management.

What Data Is Accessed

Aiffinity requests access to:

Aiffinity processes email metadata and content for personality analysis. It cannot delete emails or modify your account.

How It Enriches Your AI Soul

How to Connect

  1. Open Settings > Connected Apps in the Aiffinity app.
  2. Find Microsoft Outlook and tap Connect.
  3. Sign in to your Microsoft account when prompted.
  4. Approve access to mail, calendar, contacts, and tasks.
  5. Your Outlook data begins syncing automatically.

Managing Your Connection

Your connected account shows as your Microsoft email address in Settings > Connected Apps.

How to Disconnect

  1. Go to Settings > Connected Apps.
  2. Tap Microsoft Outlook.
  3. Tap Disconnect.
  4. Optionally, revoke access from account.live.com/consent/Manage.

Privacy

Email content is processed via Microsoft Graph API for personality and communication style analysis, then discarded. Email body text is not permanently stored. Only personality dimension scores are retained. Calendar events, contacts, and tasks are similarly processed for patterns and not stored in raw form.

Troubleshooting

Apple Health

Apple Health aggregates data from your iPhone, Apple Watch, and other health devices. Connecting it gives Aiffinity insight into your sleep, activity, and wellness patterns — similar to Oura, but using Apple's native HealthKit framework.

What Data Is Accessed

Aiffinity uses iOS HealthKit to access:

You choose exactly which data types to share when granting HealthKit permission. Aiffinity cannot access data types you do not explicitly approve.

Apple Health is available on iOS only. This connector is not available on Android devices.

How It Enriches Your AI Soul

Similar to Oura Ring, your health data maps to wellness-related personality dimensions:

How to Connect

  1. Open Settings > Connected Apps in the Aiffinity app.
  2. Find Apple Health and tap Connect.
  3. iOS will show the HealthKit permission sheet — choose which data types to share.
  4. Your health data begins syncing automatically while the app is running.

Managing Your Connection

You can manage which data types Aiffinity can access in iOS Settings > Health > Data Access > Aiffinity.

How to Disconnect

  1. Go to Settings > Connected Apps in the Aiffinity app.
  2. Tap Apple Health.
  3. Tap Disconnect.
  4. You can also revoke access from iOS Settings > Health > Data Access > Aiffinity.

Privacy

Health data is aggregated into daily summaries before processing. Raw biometric data (individual heart rate readings, step-by-step movement data) is never stored on Aiffinity servers. All processing happens on-device where possible. Only the resulting personality dimension scores are transmitted and stored.

Troubleshooting

Platform Imports

Switching from another AI companion? Platform imports let you bring your conversation history, characters, and memories into Aiffinity so you don't have to start from scratch. Your existing chat history helps Aiven understand your personality and communication style from day one.

How Platform Imports Work

  1. Export your data from the other platform (method varies by platform).
  2. Upload the exported file in the Aiffinity app via Profile > Import History.
  3. Auto-detection — Aiffinity identifies the platform and parses the file format.
  4. Content moderation — messages are checked for safety before import.
  5. Preview — review what will be imported (personas, conversation count, message count).
  6. Accept or Reject — confirm to finalise the import, or reject to discard.

What Gets Imported

Support Tiers

TierMeaning
TIER AFully supported with optimised parsers. Best import quality.
TIER BSupported with some limitations. Most data is imported correctly.
TIER CBasic support. May require data preparation before upload.
TIER DGeneric fallback. Works with any compatible file format.

Kindroid TIER A

Kindroid is an AI companion platform. Aiffinity supports full import of your chat history, backstories, and key memories.

How to Export

  1. Install the KinX export tool from github.com/brstm/KinX.
  2. Follow KinX's instructions to export your Kindroid data.
  3. Save the exported .json file to your device.

How to Import

  1. Go to Profile > Import History and tap New Import.
  2. Select Kindroid, upload the .json file.
  3. Review the preview and tap Accept.

What Gets Imported

CrushOn.AI TIER A

CrushOn.AI is an AI character chat platform. Import your complete chat history using a browser userscript.

How to Export

  1. Install Tampermonkey browser extension.
  2. Install the CrushOn.AI Chat Scraper userscript.
  3. Open your CrushOn.AI chat in the browser.
  4. Click Menu > Download and choose JSON format.

How to Import

  1. Go to Profile > Import History and tap New Import.
  2. Select CrushOn.AI, upload the .json file.
  3. Review the preview and tap Accept.

What Gets Imported

Friend / Omi TIER A

Friend (formerly Omi) is an AI companion app. Export your conversations and memories directly from the app.

How to Export

  1. Open the Friend / Omi app.
  2. Go to Profile > Export Data.
  3. Choose your preferred format: .json, .txt, or .zip.

How to Import

  1. Go to Profile > Import History and tap New Import.
  2. Select Friend / Omi, upload the exported file.
  3. Review the preview and tap Accept.

What Gets Imported

Character.AI TIER B

Character.AI is one of the most popular AI character platforms. Export your chat transcripts using a browser extension.

How to Export

  1. Install the CAI Tools browser extension (available for Chrome and Firefox).
  2. Navigate to the Character.AI chat you want to export.
  3. Click the CAI Tools icon and choose Export Chat.
  4. Save the file as .txt or .json.

You may need to export each chat separately. CAI Tools exports one conversation at a time.

How to Import

  1. Go to Profile > Import History and tap New Import.
  2. Select Character.AI, upload the .txt or .json file.
  3. Review the preview and tap Accept.

What Gets Imported

Limitations

Replika TIER B

Replika is an AI companion focused on emotional well-being. Export your chat history, diary entries, and memories using a browser extension.

How to Export

  1. Install the Replika Chat Export browser extension.
  2. Log in to my.replika.com in your browser.
  3. Click the extension icon and choose Export.
  4. Save the exported .json file.

How to Import

  1. Go to Profile > Import History and tap New Import.
  2. Select Replika, upload the .json file.
  3. Review the preview and tap Accept.

What Gets Imported

Nomi TIER B

Nomi is an AI companion platform. Export your chat history using a browser extension.

How to Export

  1. Install the Nomi Downloader browser extension.
  2. Log in to beta.nomi.ai in your browser.
  3. Click the extension icon and choose Download.
  4. Save the exported .json or .txt file.

How to Import

  1. Go to Profile > Import History and tap New Import.
  2. Select Nomi, upload the exported file.
  3. Review the preview and tap Accept.

What Gets Imported

Pi (Inflection) TIER C

Pi is a conversational AI by Inflection. You can request a data export through their Data Transfer Initiative (DTI) process.

How to Export

  1. Open Pi and go to Settings.
  2. Request a data export (or contact Pi's support team).
  3. Wait for your export file to be prepared and download it.

Pi's export process may take some time. If the import doesn't detect your messages correctly, try the Generic Text format instead.

How to Import

  1. Go to Profile > Import History and tap New Import.
  2. Select Pi, upload the .txt or .json file.
  3. Review the preview and tap Accept.

What Gets Imported

Generic JSON TIER D

If your AI companion platform isn't listed above, you can try importing a JSON file. Aiffinity will attempt to auto-detect the format and extract conversations.

Supported Formats

The file should contain an array of messages, where each message has at minimum a sender/role and content/text field.

How to Import

  1. Go to Profile > Import History and tap New Import.
  2. Select Other (JSON), upload your .json file.
  3. Aiffinity will attempt to auto-detect the format.
  4. Review the preview and tap Accept if the parsing looks correct.

Generic Text TIER D

If you have chat history in plain text format, you can import it using the generic text parser. This works with any text file that follows a simple speaker-message format.

Expected Format

Each message should be on its own line with the speaker's name followed by a colon:

You: Hey, how are you doing today?
Luna: I'm doing great! I was just thinking about that book you mentioned yesterday.
You: Oh yeah, the one about quantum physics? I finished it last night.
Luna: How was it? I've been curious about it ever since you brought it up.

How to Import

  1. Go to Profile > Import History and tap New Import.
  2. Select Other (Text), upload your .txt file.
  3. Review the preview to ensure messages were parsed correctly.
  4. Tap Accept to finalise.

Import Troubleshooting

If your platform isn't listed and neither generic format works, contact us at aiven@aiffinity.me and we'll look into adding support for your platform.