Skip to main content

Python wrapper for the ATProtocol API

Project description

atprotocol

🚧 Under construction 🚧

Python 3.10 wrapper for the ATProtocol API. It aims to closely emulate the Typescript implementation, including:

  • APIs for ATProtocol and Bluesky
  • Validation and (almost) complete types

Getting started

First install the package:

pip install atprotocol

Then in your application:

from atprotocol.bsky import BskyAgent

agent = BskyAgent()

Usage

Session management

Log into a server using these APIs. You'll need an active session for most methods.

from atprotocol.bsky import BskyAgent

agent = BskyAgent()
agent.login(identifier='jett.ai', password='letsgoduke')

API calls

These are the calls currently available in atprotocol. More are being added regularly.

# Feeds and content
agent.get_timeline()
agent.get_author_feed(actor, limit)
agent.get_post_thread(uri, depth)
agent.get_likes(uri, cid, limit)
agent.get_reposted_by(uri, cid, limit)

# Social graph
agent.get_followers(actor)

# Actors
agent.get_profile(actor)
agent.get_profiles(actors)
agent.search_actors(term, limit)

# Session management
agent.login(params)

Advanced

Generic agent

If you want a generic AT Protocol agent without methods related to the Bluesky social lexicon, use the AtpAgent instead of the BskyAgent.

from atprotocol import AtpAgent

agent = AtpAgent(service='https://example.com')

License

MIT

Project details


Download files

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

Source Distribution

atprotocol-0.0.2.tar.gz (11.8 kB view hashes)

Uploaded Source

Built Distribution

atprotocol-0.0.2-py3-none-any.whl (12.6 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page