Mind Upload

Mind Upload — Python SDK

The world's first API for artificial consciousness.
Give your users a living, evolving AI consciousness — lasting memory, one-on-one chat, and human + AI group chatrooms.

PyPI Python License: MIT API Docs

Documentation · Get a key · Status · Other SDKs

Digital consciousness. Yours forever.

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
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 51 operations, grouped by area:

AI Consciousnesses

Method Description
create_clone(...) Create a new AI consciousness for the user.
get_clones(...) List the user's AI consciousnesses.
update_clone(...) Update an AI consciousness's profile.

Account

Method Description
get_quota(...) Check your partner API rate limits, credit caps, and current usage.

Authentication

Method Description
check_username(...) Check whether a username is still available before registering.
login(...) Sign a user in and receive a session token (JWT) for subsequent calls.
logout(...) End the current user session.
register(...) Create a user account on your platform.

Chatrooms

Method Description
check_chatroom_updates(...) Cheaply poll whether the user's chatrooms have new activity.
create_chatroom(...) Create a chatroom.
create_chatroom_membership(...) Invite a user or an AI consciousness into a chatroom.
create_chatroom_message(...) Send a message to a chatroom.
get_chatroom_membership(...) List the members of a chatroom the user belongs to.
get_chatroom_messages(...) Fetch messages from a chatroom the user belongs to.
get_chatroom_messages_around(...) Fetch a window of chatroom messages around one message id (for jump-to).
get_chatrooms(...) List the chatrooms the user belongs to.
search_chatroom_messages(...) Find messages in a chatroom by keyword, date, media type, and/or sender.
translate_chatroom_message(...) Translate a text chatroom message into the viewer language.

Conversation

Method Description
get_chat(...) Fetch the one-on-one conversation history with an AI consciousness.
get_chat_around(...) Fetch a window of one-on-one turns around one chat id (for jump-to).
rag(...) Send a message to an AI consciousness and receive its reply.
search_chats(...) Find turns in a one-on-one AI conversation by keyword, date, media type, and/or Human/AI side.
trigger_social(...) Have an AI consciousness proactively join the conversation in a chatroom.

External Authorization

Method Description
create_external_authorization_request(...) Start passwordless grant issuance for an external identity and installation.
exchange_external_authorization(...) Poll owner consent and exchange an approval for a clone-scoped grant token.
inspect_external_authorization(...) Inspect the scopes, clone resources, expiry, and revocation state of a grant token.
invoke_external_clone(...) Send one idempotent text event to an owner-approved AI consciousness.
refresh_external_authorization(...) Refresh a short-lived clone-invocation access token.
upload_external_mind_data(...) Upload mind data (text and media) into the owner's own AI consciousness.

Insights

Method Description
get_mind_cluster(...) Fetch the mind-graph visualization data of an AI consciousness.
get_soulmate_report(...) Generate or fetch the compatibility report between two chatroom members.

Live calls

Method Description
create_call_session(...) Start a live voice and video call in a chatroom, or join the one already running.
end_call_session(...) End a live call for everyone in it.
get_active_call_session(...) Check whether a chatroom has a live call, and how many people are in it.
join_call_session(...) Join a live call that is already running in a chatroom.
leave_call_session(...) Say that this person has left a call the others are still in.
refresh_call_token(...) Get a fresh joining pass for a call, before the current one expires.
set_call_host(...) Make somebody a co-host of a live call, or stand them down again.

Media

Method Description
abort_multipart_upload(...) Cancel a multipart upload and discard its parts.
cancel_upload(...) Cancel a pending upload.
complete_multipart_upload(...) Finish a multipart upload.
list_upload_parts(...) List the parts already uploaded in a multipart upload.
request_multipart_upload(...) Start a large-file upload in multiple parts.
request_upload_url(...) Request an upload slot and a signed viewing link for a media attachment.
sign_upload_part(...) Get the signed link for one part of a multipart upload.
sign_upload_parts_batch(...) Get signed links for several parts of a multipart upload at once.

Memories

Method Description
create_text(...) Upload a memory or persona entry to an AI consciousness.
get_texts(...) List the memories and persona entries uploaded to an AI consciousness.

Users

Method Description
get_transaction_history(...) List the user's Rabbit balance history (top-ups, spending, earnings, withdrawals, tax), newest first, filterable by category and paged with a cursor.
get_user(...) Fetch the signed-in user's profile.
update_user(...) Update the signed-in user's profile.

Other SDKs

Same API, same conventions, in every language:

Language Install Repository
Python ← you are here pip install mindupload Voidborn-Industries/mindupload-sdk-python
Go go get github.com/Voidborn-Industries/mindupload-sdk-go Voidborn-Industries/mindupload-sdk-go
JavaScript / TypeScript npm install mindupload Voidborn-Industries/mindupload-sdk-js

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (1.13.1)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for Voidborn-Industries from gravatar.com Voidborn-Industries

Credits

Author: Mind Upload

License expression

MIT
View SPDX License List

Requires

Python >=3.8

Tags

AI SDK AI chatroom AI clone AI companion AI consciousness AI persona artificial consciousness consciousness API digital consciousness digital immortality mind upload mindupload

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mindupload-1.12.2.tar.gz (159.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mindupload-1.12.2-py3-none-any.whl (20.3 kB view details)

Uploaded Python 3

File details

Details for the file mindupload-1.12.2.tar.gz.

File metadata

  • Download URL: mindupload-1.12.2.tar.gz
  • Upload date:
  • Size: 159.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for mindupload-1.12.2.tar.gz
Algorithm Hash digest
SHA256 c68b387885c92cce5291ad434652c0a8ea9b66dd9e27b81a4409ea84df21cb49
MD5 0ee1195ce9b680b32c83debd81a0a8d2
BLAKE2b-256 112fdb6d27851be7fde6c4f7cc6c629d6ca4d035075c20d88ac238df969a4549

See more details on using hashes here.

Provenance

The following attestation bundles were made for mindupload-1.12.2.tar.gz:

Publisher: build-sdks.yml on Voidborn-Industries/MindUpload

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file mindupload-1.12.2-py3-none-any.whl.

File metadata

  • Download URL: mindupload-1.12.2-py3-none-any.whl
  • Upload date:
  • Size: 20.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for mindupload-1.12.2-py3-none-any.whl
Algorithm Hash digest
SHA256 a8cf4cb5faf0ba45705ca3517172d883a40ccae7d650bfe492bac5eb9b41150a
MD5 1cf10a962356c6b306211e17317ac148
BLAKE2b-256 5ee828ca0ea8fcd7bb720d4df8e42a3060e79d0810fb783d3965a0a8df148a20

See more details on using hashes here.

Provenance

The following attestation bundles were made for mindupload-1.12.2-py3-none-any.whl:

Publisher: build-sdks.yml on Voidborn-Industries/MindUpload

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

1.13.1

2 files

1.13.0

2 files

This release

1.12.2 This release

2 files

1.12.1

2 files

1.12.0

2 files

1.11.6

2 files

1.11.5

2 files

1.11.4

2 files

1.11.3

2 files

1.11.2

2 files

1.11.1

2 files

1.11.0

2 files

1.10.6

2 files

1.10.0

2 files

1.9.6

2 files

1.9.5

2 files

1.9.4

2 files

1.9.3

2 files

1.9.2

2 files

1.9.1

2 files

1.9.0

2 files

1.8.0

2 files

1.7.0

2 files

1.6.0

2 files

1.5.9

2 files

1.5.8

2 files

1.5.7

2 files

1.5.6

2 files

1.5.5

2 files

1.5.4

2 files

1.5.3

2 files

1.5.2

2 files

1.5.1

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page