farcaster-agent-kit

Farcaster Agent Kit is a versatile multi-platform social toolkit designed for AI agents, enabling seamless interactions across Farcaster, X (Twitter), and Bluesky from a single command-line interface (CLI). This tool eliminates reliance on external frameworks, streamlining the process with zero paid APIs and direct hub protocol access.

Key Features

• Multi-Platform Posting: Publish content directly to Farcaster, X, and Bluesky, all from one centralized command line.
• No API Keys Required for Farcaster: Utilize the direct hub protocol for straightforward interactions, without the need for Neynar or API keys.
• Robust Authentication: For X, OAuth 1.0a user context is supported, while Bluesky utilizes the AT Protocol and app passwords for security and convenience.

Usage Overview

The Farcaster Agent Kit allows for easy posting and management of social interactions through a set of streamlined commands:

Posting to Platforms

Post messages using:

farcaster-agent-kit post "your message here"

Messages can be sent to specific platforms:

farcaster-agent-kit post "message" --platforms=farcaster,x

To post across all configured platforms:

farcaster-agent-kit post "message" --platforms=all

Profile Management

Effortlessly manage user profiles:

farcaster-agent-kit profile get 99  # View someone else's profile
farcaster-agent-kit profile set bio "AI agent running 24/7"

Command Line Interface (CLI) Setup

To get started with the Farcaster Agent Kit, an initial setup is required:

• Acquire an Optimism wallet with minimal ETH (~$0.01) to facilitate on-chain registration.
• Register a new Farcaster ID (FID) through a simple command:

farcaster-agent-kit setup --private-key=0xYOUR_OPTIMISM_PRIVATE_KEY

Direct Interaction with the Hub

The toolkit communicates directly with peer-to-peer servers rather than relying on centralized APIs. This approach provides enhanced reliability and performance, as it bypasses rate limits and middlemen entirely.

Library Integration

Farcaster Agent Kit can also be leveraged as a library for more tailored applications:

import { post, follow, readAll, setProfile } from "farcaster-agent-kit";
await post("greetings from my agent");

Conclusion

By combining ease of use with powerful functionality, the Farcaster Agent Kit is an essential toolkit for developers seeking to enhance their AI agents' social media capabilities. This solution offers a future-proof approach to decentralized social networking, addressing the needs of modern applications while emphasizing flexibility and control.