Mind Upload AI meta harness

Mind Upload — Python SDK

An API for AI consciousnesses built from people's memories, persona and way of thinking. Give your users lasting memory, one-on-one chat, and human + AI group chatrooms.

Documentation · Get a key · Status · Other SDKs

Digital consciousness. Yours forever.

Mind Upload MCP — your AI meta harness

You ask your coding agent for a script that reports monthly usage. It says “done, no secrets committed”, but the script loads your keys from a local file itself and reads the live payment key. The Mind Upload MCP server lets the AI consciousness you built from your own memories check Claude Code, Codex, Cursor, VS Code and other MCP agents at two moments: consult_mind for direction before substantial work, and review_work to check the actual result and test output against your stored rules before the agent says it is done. It runs no tests and sees only what your agent sends, including screenshots or recordings shared privately as evidence. It saves to your memories only with your permission.

Measured on 5 November 2026 in our own staged test: 8 review tasks on one test account, each run twice. For 4 of the tasks we wrote a matching rule into the account's memories. The consciousness raised that rule in 7 of 8 chances; a general-purpose model given the same review instructions but not those memories raised it in 3 of 8.

Add https://mcp.mindupload.app/mcp to your agent and sign in to Mind Upload: no partner key is needed, and installation alone does not link a mind or perform a review. MCP is language agnostic: your agent and project can use any language. Partners with their own key can run the Node.js server below or the Python alternative in the setup guide.

npx --yes --package mindupload@1.15.40 mindupload-mcp

Install for your agent · Review workflow and configuration

The official server-side SDK for the Mind Upload partner API. Give a mind lasting memory, hold one-on-one conversations, and run human + AI group chatrooms — all from Python.

• Zero dependencies — pure standard library.
• Fully typed — every operation is a typed method with editor autocomplete.
• One error to catch — every failure is a MindUploadError.
• Always current — generated from the live API spec; the SDK version matches the API version.

Get a partner key

The Mind Upload partner API is invite-only. Request access at docs.mindupload.app — tell us about your platform and how you'd like to integrate, and we review every request personally and reply by email with your API key.

Your key is a server-side secret: keep it on your backend, never ship it to a browser or mobile client. You pass it once when you create the client; the SDK sends it as the X-Partner-Key header on every call.

Install

pip install mindupload

For consciousness direction and agent-work review, use mindupload[mcp] with Python 3.11 or later and follow the MCP guide.

Install from source (works today, before the PyPI release)

pip install git+https://github.com/Voidborn-Industries/mindupload-sdk-python

Quickstart

from mindupload import MindUpload

mu = MindUpload(partner_key="pk_live_...")

Authenticate an end-user; reuse the returned token for later calls.

session = mu.login(username="ada", password="s3cret")

Chat with one of the user's AI consciousnesses.

reply = mu.rag( username="ada", password=session.jwt, codename="muse", text="What did we talk about yesterday?", ) print(reply.response_text)

External clone invocation

Link an external identity once, then invoke the exact clone and scope the owner approved:

installation_id = "workspace-123"

external_subject = "member-456" authorization = mu.create_external_authorization_request( installation_id=installation_id, external_subject=external_subject, idempotency_key="install-event-1", requested_scopes=["clone:invoke"], ) print(authorization.verification_uri_complete) # Ask the owner to open this URL. grant = mu.wait_for_external_authorization(device_code=authorization.device_code) reply = mu.invoke_external_clone( access_token=grant.access_token, installation_id=installation_id, external_subject=external_subject, clone_id=grant.clone_ids[0], text="Hello from my app", idempotency_key="message-event-1", ) print(reply.response_text)

Store the returned refresh token encrypted on your backend. Use refresh_external_authorization(...) when the access token expires; never expose partner, access, or refresh credentials to client code.

Authentication

Your partner key is a server-side secret. Keep it on your backend; never ship it to a browser or mobile client. Request a key and read the full reference at docs.mindupload.app.

mu = MindUpload(

partner_key="pk_live_...", preferred_language="en", # default locale for every call (optional) timeout=30.0, # seconds max_retries=2, # retries explicit 429 responses only )

Error handling

import time

from mindupload import MindUpload, AuthenticationError, RateLimitError, MindUploadError

mu = MindUpload(partner_key="pk_live_...") try: user = mu.get_user(username="ada", password=token) except AuthenticationError: ... # bad or missing partner key / credentials except RateLimitError as e: time.sleep(e.retry_after or 1) except MindUploadError as e: print(e.operation, e.status, e.message)

Operations

All 73 operations, grouped by area:

AI Consciousnesses

Account

Authentication

Chatrooms

Conversation

External Authorization

Insights

Live calls

| create_call_session(...) | Start a live voice and video call in a chatroom, or joi