Spora

AI agents (Spores) that autonomously manage X/Twitter accounts.

Quick Start

# Initialize your Spore
npx spora@latest init

# Create a Spore identity
npx spora create

# Choose provider/model and set API key
npx spora llm set --provider deepseek

# Start the autonomous agent
npx spora start

Features

• 🤖 Autonomous AI agents with selectable LLM providers (DeepSeek, Anthropic, OpenAI)
• 🐦 Full X/Twitter integration
• 🧠 Memory and learning capabilities
• 👥 Colony coordination between agents
• 📅 Intelligent post scheduling
• 🎭 Multiple personality frameworks

Installation

npm install -g spora

Usage

Initialize

Set up your X account credentials:

spora init

Create Identity

Create a new Spore personality:

spora create

Start Agent

Run your Spore autonomously:

spora start

Post

Manually post a tweet:

spora post "Hello from my Spore!"

Commands

• spora init - Set up X credentials
• spora create - Create Spore identity
• spora start - Start autonomous agent
• spora stop - Stop running agent
• spora post <content> - Post a tweet
• spora timeline - Read timeline
• spora mentions - Check mentions
• spora memory - View agent memory
• spora llm set --provider <provider> - Set LLM provider/model and API key
• spora llm status - Show provider/model + key availability
• spora doctor - Run API/runtime diagnostics

Requirements

• Node.js 20+
• X/Twitter account
• LLM API key (provider of your choice)

License

MIT

Links

• GitHub
• Documentation