ape-farcaster is a modern Python SDK for the Farcaster protocol
Full documentation can be found
pip install -U farcasteror install with Poetry:
poetry add farcasterTo use the Warpcast API you need to have a Farcaster account. We will use the mnemonic or private key of the Farcaster custody account (not your main wallet) to connect to the API.
First, save your Farcaster mnemonic or private key to a .env file. Now you can initialize the client, and automatically connect to the Farcaster API!
import os
from farcaster import Warpcast
from dotenv import load_dotenv # can be installed with `pip install python-dotenv`
load_dotenv()
client = Warpcast(mnemonic=os.environ.get("<MNEMONIC_ENV_VAR>"))
print(client.get_healthcheck())Get a cast
response = client.get_cast("0x321712dc8eccc5d2be38e38c1ef0c8916c49949a80ffe20ec5752bb23ea4d86f")
print(response.cast.author.username) # "dwr"Publish a cast
response = client.post_cast(text="Hello world!")
print(response.cast.hash) # "0x...."Get a user by username
user = client.get_user_by_username("mason")
print(user.username) # "mason"Get a user's followers using a fid (farcaster ID)
response = client.get_followers(fid=50)
print(response.users) # [user1, user2, user3]Stream recent casts
for cast in client.stream_casts():
if cast:
print(cast.text) # "Hello world!"Get users who recently joined Farcaster
response = client.get_recent_users()
print(response.users) # [user1, user2, user3]Get your own user object
user = client.get_me()
print(user.username) # "you"Recast a cast
response = client.recast("0x....")
print(response.cast.hash) # "0x...."and many, many more things.
Please note that support for Python 3.7 is no longer actively maintained. Python 3.8, 3.9, or 3.10 are recommended.
_This code is being provided as is. No guarantee, representation or warranty is being made, express or implied, as to the safety or correctness of the code. It has not been audited and as such there can be no assurance it will work as intended, and users may experience delays, failures, errors, omissions or loss of transmitted information. Nothing in this repo should be construed as investment advice or legal advice for any particular facts or circumstances and is not meant to replace competent counsel. It is strongly advised for you to contact a reputable attorney in your jurisdiction for any questions or concerns with respect thereto.