# 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](https://github.com/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

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

#### 2. Install Dependencies

```bash
bun install
```

#### 3. Configure Environment

Copy the example environment file and fill in your credentials:

```bash
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

```bash
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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.chaingpt.org/dev-docs-b2b-saas-api-and-sdk/chaingpt-claude-skill-and-plugin/products/agenticos.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.