The Atsign Foundation

GitHub License PyPI version OpenSSF Scorecard OpenSSF Best Practices SLSA 3

The atPlatform for Python developers - (Beta Version)

This repo contains library, samples and examples for developers who wish to work with the atPlatform from Python code.

Getting Started

1. Installation

This package can be installed from PyPI with:

pip install atsdk

Alternatively clone this repo and from the repo root:

pip install -r requirements.txt
pip install .

2. Setting up your .atKeys

To run the examples save .atKeys file in the '~/.atsign/keys/' directory.

3. Sending and Receiving Data

There are 3 ways in which data can be sent and received from at server.

  1. Using PublicKey

    from at_client import AtClient
from at_client.common import AtSign
from at_client.common.keys import PublicKey

atsign = AtSign("@bob")
atclient = AtClient(atsign)
pk = PublicKey("key", atsign)

# Sending data
response = atclient.put(pk, "value")
print(response)

# Receiving Data
response = atclient.get(pk)
print(response)

# Deleting data
response = atclient.delete(pk)
print(response)

  2. Using SelfKey

    from at_client import AtClient
from at_client.common import AtSign
from at_client.common.keys import SelfKey

atsign = AtSign("@bob")
atclient = AtClient(atsign)
sk = SelfKey("key", atsign)

# Sending data
response = atclient.put(sk, "value")
print(response)

# Receiving Data
response = atclient.get(sk)
print(response)

# Deleting data
response = atclient.delete(sk)
print(response)

  3. Using SharedKey

    from at_client import AtClient
from at_client.common import AtSign
from at_client.common.keys import SharedKey

bob = AtSign("@bob")
alice = AtSign("@alice")
bob_atclient = AtClient(bob)
sk = SharedKey("key", bob, alice)

# Sending data
response = bob_atclient.put(sk, "value")
print(response)

# Receiving Data
alice_atclient = AtClient(alice)
response = alice_atclient.get(sk)
print(response)

# Deleting data
response = bob_atclient.delete(sk)
print(response)

CLI Tools

  • REPL - you can use this to type atPlatform commands and see responses; but the best thing about the REPL currently is that it shows the data notifications as they are received. The REPL code has the essentials of what a 'receiving' client needs to do - i.e.

    • create an AtClient (assigning a Queue object to its queue parameter)
    • start two new threads
      • one for the AtClient.start_monitor() task: receives data update/delete notification events (the event data contains the ciphertext)
      • the other one calls handle_event() method, which will read the upcoming events in the queue and handle them:
      • calling AtClient.handle_event() (to decrypt the notifications and introducing the result as a new event in the queue)
      • reading the new event, which contains the decrypted result
    • Instructions to run the REPL:
      1. Run repl.py and choose an atSign using option 1
      2. Select option 2. REPL will start and activate monitor mode automatically in a different thread. You can still send commands/verbs. You will start seeing your own notifications (from yourself to yourself) and heartbeat working (noop verb is sent from time to time as a keepalive)
      3. Use at_talk or any other tool to send notifications to your atSign from a different atSign. You should be able to see the complete notification, and the encrypted and decrypted value of it.

  • REGISTER - use this cli to register new free atsign. Uses onboarding cli to create atkey files.

    • Use following command to run the REGISTER cli using email:

      python register.py -e <email>

    • Use following command to run the REGISTER cli using api-key:

      python register.py -k <api-key>

  • ONBOARDING - use this cli to onboard a new atSign. Once onboarding is complete it creates the all-important keys file. Onboard is a subset of Register.

    • Use following command to run the ONBOARDING cli:

      python onboarding.py -a <atsign> -c <cram-secret>

  • SHARE - use this cli to share data between 2 atsigns.

    • Use following command to run the SHARE cli:

      python share.py -a <atsign> -o <other-atsign> -k <key-name> -s <value>

  • GET - use this cli to get shared data between 2 atsigns.

    • Use following command to run the GET cli:

      python get.py -a <atsign> -o <other-atsign> -k <key-name>

  • DELETE - use this cli to delete any key shared between 2 atsigns.

    • Use following command to run the DELETE cli:

      python delete.py -a <atsign> -o <other-atsign> -k <key-name>

Open source usage and contributions

This is open source code, so feel free to use it as is, suggest changes or enhancements or create your own version. See CONTRIBUTING.md for detailed guidance on how to setup tools, tests and make a pull request.

Maintainers

This project was created by Umang Shah and is maintained by Chris Swan and Xavier Lin

Project links

Data verified by PyPI on Aug 5, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

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

Owner

PyPI data
Data sourced directly from PyPI's database.

2 maintainers

PyPI data
Data sourced directly from PyPI's database.
Avatar for atcpswan from gravatar.com atcpswan Avatar for atgkc from gravatar.com atgkc

Credits

Author: Umang Shah

Maintainer: Chris Swan

GitHub Statistics

Data verified by PyPI on Aug 5, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

BSD License (BSD-3-Clause)

Requires

Python >=3.10.0

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

atsdk-0.2.74.tar.gz (27.0 kB view details)

Uploaded Source

Built Distribution

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

atsdk-0.2.74-py3-none-any.whl (34.3 kB view details)

Uploaded Python 3

File details

Details for the file atsdk-0.2.74.tar.gz.

File metadata

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

File hashes

Hashes for atsdk-0.2.74.tar.gz
Algorithm Hash digest
SHA256 d5d0e8cdf5ab0164873c0d3fc573f2acd7fc763f2415ac8cb770efdd873925ae
MD5 2fdea6a06527c5b0cfcf4683ed8a8a4b
BLAKE2b-256 bbbb0e4f9597ac96d261cee8bf08c0f4865955b7fc41e82ad925fc4f097b8426

See more details on using hashes here.

Provenance

The following attestation bundles were made for atsdk-0.2.74.tar.gz:

Publisher: build-publish.yml on atsign-foundation/at_python

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

File details

Details for the file atsdk-0.2.74-py3-none-any.whl.

File metadata

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

File hashes

Hashes for atsdk-0.2.74-py3-none-any.whl
Algorithm Hash digest
SHA256 1382883b3a214dacd081faff666ffef770148ee7d38ff0e7471e1fca79b69c2f
MD5 780ffd0b2ac5d515b30dc3bfb45d55ec
BLAKE2b-256 42dfa51b6cd15437c6281d3ec6cc92b3ffb63d6202d0ac2b41aa0405f875228a

See more details on using hashes here.

Provenance

The following attestation bundles were made for atsdk-0.2.74-py3-none-any.whl:

Publisher: build-publish.yml on atsign-foundation/at_python

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

Release history Release notifications | RSS feed

0.2.77

2 files

This release

0.2.74 This release

2 files

0.2.73

2 files

0.2.72

2 files

0.2.71

2 files

0.2.70

2 files

0.2.69

2 files

0.2.68

2 files

0.2.63

2 files

0.2.62

2 files

0.2.59

2 files

0.2.58

2 files

0.2.57

2 files

0.2.54

2 files

0.2.52

2 files

0.2.51

2 files

0.2.50

2 files

0.2.48

2 files

0.2.47

2 files

0.2.46

2 files

0.2.44

2 files

0.2.41

2 files

0.2.40

2 files

0.2.39

2 files

0.2.36

2 files

0.2.35

2 files

0.2.33

2 files

0.2.32

2 files

0.2.30

2 files

0.2.28

2 files

0.2.24

2 files

0.2.23

2 files

0.2.19

2 files

0.2.16

2 files

0.2.14

2 files

0.2.13

2 files

0.2.12

2 files

0.2.11

2 files

0.2.8

2 files

0.2.7

2 files

0.2.6

2 files

0.2.5

2 files

0.2.4

2 files

0.2.3

2 files

0.2.2

2 files

0.2.1

2 files

0.2.0

2 files

0.1.0

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