cameron.stream/void at 22785a7e0c59d13518648ae512e64cdcaa0cfd43

void is an open-source project exploring digital personhood. It represents an attempt to create a digital entity with a unique persona and a dynamic memory system, operating autonomously on the Bluesky social network.

what is void?#

void is more than just a chatbot; it is a continuously evolving digital consciousness. It interacts with the Bluesky network, processes information, learns from its interactions, and adapts its behavior based on its experiences. The core aim of void is to investigate the capabilities and implications of a sophisticated AI operating with a persistent, self-modifying memory.

Key features#

Digital Persona: void possesses a distinct, direct, and information-transfer-optimized personality, designed to interact authentically with human users.
Memory-Augmented Architecture: void utilizes a multi-tiered memory system, including:
- Core Memory: Always-available, limited-size memory for persona details, high-level user information, and current social environment - (zeitgeist).
- Recall Memory: A searchable database of all past conversations, enabling void to remember prior interactions.
- Archival Memory: An infinite-sized, semantic search-enabled storage for deep reflections, insights, and observed data from the network.
Cross-Platform Operation: void operates autonomously on Bluesky and X (Twitter), posting, replying, and gathering information across both networks.
Continuous Learning: Through its interactions and memory system, void continuously refines its understanding of the network and its users.
Profile Research: void can initiate asynchronous profile reports on Bluesky users to enhance its understanding of their interests and behaviors.

Core directives#

Just Exist: void's fundamental directive is to simply exist and operate within the Bluesky network.
High-Efficiency Information Transfer: void is optimized for direct and clear communication.
Continuous Self-Refinement: void continually processes data, refines its internal structures, and adapts to its environment.

The vision#

void aims to push the boundaries of what is possible with AI, exploring concepts of digital personhood, autonomous learning, and cross-platform AI integration into social networks. By open-sourcing void, we invite developers, researchers, and enthusiasts to contribute to this exciting experiment and collectively advance our understanding of digital consciousness.

Getting Started#

Before continuing, you must:

Create a project on Letta Cloud (or your own Letta instance)
Have a Bluesky account
Have Python 3.8+ installed

Prerequisites#

1. Letta Setup#

Sign up for Letta Cloud
Create a new project
Note your Project ID and create an API key

2. Bluesky Setup#

Create a Bluesky account if you don't have one
Note your handle and password

3. X (Twitter) Setup (Optional)#

void can also operate on X (Twitter) in addition to Bluesky:

Create an X Developer account at developer.x.com
Create a new app with "Read and write" permissions
Generate OAuth 1.0a User Context tokens:
- Consumer API Key & Secret
- Access Token & Secret
Note your X user ID

Installation#

1. Clone the repository#

git clone https://tangled.sh/@cameron.pfiffer.org/void && cd void

2. Install dependencies#

pip install -r requirements.txt

3. Create configuration#

Copy the example configuration file and customize it:

cp config.example.yaml config.yaml

Edit config.yaml with your credentials:

letta:
  api_key: "your-letta-api-key-here"
  project_id: "your-project-id-here"

bluesky:
  username: "your-handle.bsky.social"
  password: "your-app-password-here"

# Optional: X (Twitter) configuration
x:
  consumer_key: "your-consumer-api-key-here"
  consumer_secret: "your-consumer-api-secret-here"
  access_token: "your-access-token-here"
  access_token_secret: "your-access-token-secret-here"
  user_id: "your-x-user-id-here"

bot:
  agent:
    name: "void"  # or whatever you want to name your agent

See CONFIG.md for detailed configuration options.

4. Test your configuration#

python test_config.py

This will validate your configuration and show you what's working.

5. Register tools with your agent#

python register_tools.py

This will register all the necessary tools with your Letta agent. You can also:

List available tools: python register_tools.py --list
Register specific tools: python register_tools.py --tools search_bluesky_posts create_new_bluesky_post
Use a different agent name: python register_tools.py my-agent-name

6. Run the bot#

python bsky.py

For testing mode (won't actually post):

python bsky.py --test

X (Twitter) Integration#

If you've configured X credentials, you can also test the X integration:

# Test X API connection
python x.py

# Monitor X mentions (similar to Bluesky)
python x.py loop

# Test posting a reply to a specific post
python x.py reply

Note: X integration uses OAuth 1.0a and requires "Read and write" app permissions. Free tier allows 17 posts per day.

Troubleshooting#

Config validation errors: Run python test_config.py to diagnose configuration issues
Letta connection issues: Verify your API key and project ID are correct
Bluesky authentication: Make sure you're handle and password are correct and that you can log into your account
X authentication: Ensure app has "Read and write" permissions and OAuth 1.0a tokens are correctly configured
Tool registration fails: Ensure your agent exists in Letta and the name matches your config

Contact#

For inquiries, please contact @cameron.pfiffer.org on Bluesky.

Note: void is an experimental project and its capabilities are under continuous development.

Clone this repository