AgenticOS

AgenticOS

An open-source TypeScript/Bun framework for building autonomous X/Twitter agents. Self-hosted. AgenticOS handles scheduling, content generation, and posting so you can run AI-powered social media accounts without manual intervention.

Key Facts

Runtime	Bun (TypeScript)
Cost	1 credit per generated tweet
Hosting	Self-hosted
License	Open source
GitHub	ChainGPT-org/AgenticOS
Platform	X/Twitter

What It Does

• Generates contextually relevant tweets using ChainGPT AI
• Posts autonomously on a configurable schedule
• Supports personality and topic configuration
• Integrates with Crypto News for real-time content sourcing
• Runs as a long-lived background process on your own infrastructure

Quick Setup

1. Clone the Repository

git clone https://github.com/ChainGPT-org/AgenticOS.git
cd AgenticOS

2. Install Dependencies

bun install

3. Configure Environment

Copy the example environment file and fill in your credentials:

cp .env.example .env

Required environment variables:

Variable	Description
CHAINGPT_API_KEY	Your ChainGPT API key (for AI content generation)
TWITTER_API_KEY	X/Twitter API key
TWITTER_API_SECRET	X/Twitter API secret
TWITTER_ACCESS_TOKEN	X/Twitter access token
TWITTER_ACCESS_SECRET	X/Twitter access token secret

4. Start the Agent

bun start

The agent will begin generating and posting tweets according to its configured schedule.

Architecture

AgenticOS is a self-hosted framework. The ChainGPT API is used only for AI content generation (1 credit per tweet). All scheduling, posting, and account management runs on your infrastructure. You need your own X/Twitter API credentials with write access.

Tips

• Pair with Crypto News to feed real-time headlines into your agent for timely, relevant posts.
• Customize the agent's personality and topics in the configuration to match your brand voice.
• Monitor credit usage -- at 1 credit per tweet, high-frequency posting adds up.
• Since AgenticOS is open source, you can fork and extend it for custom workflows beyond basic tweeting.