Twitter Ai Agent with Gemini Integration 🤖

An intelligent Twitter (X) agent powered by Google's Gemini AI that allows you to post tweets using natural language commands. This project demonstrates the integration of AI with social media APIs to create powerful automation tools.

✨ Features

• Natural Language Processing: Post tweets using everyday language
• AI-Powered: Leverages Google's Gemini 2.0 Flash model
• Real-time Interaction: Command-line interface for seamless interaction
• Secure: Environment-based configuration for sensitive credentials
• Extensible: Built with a modular architecture for easy expansion

🛠️ Tech Stack

• Backend: Node.js, Express
• AI: Google Gemini 2.0 Flash
• APIs: Twitter API v2
• Protocol: Model Context Protocol (MCP)
• Authentication: OAuth 1.0a

📦 Prerequisites

• Node.js (v16+)
• npm or yarn
• Twitter Developer Account
• Google Cloud Project with Gemini API enabled

Installation

1. Clone the repository

   git clone https://github.com/adarshpheonix2810/Twitter-Ai-Agent.git
   cd Twitter-Ai-Agent
   

2. Install dependencies

   # Install server dependencies
   cd server
   npm install
   
   # Install client dependencies
   cd ../client
   npm install
   

3. Set up environment variables

   Create a .env file in both client and server directories:

   client/.env

   GEMINI_API_KEY=your_gemini_api_key_here
   

   server/.env

   TWITTER_API_KEY=your_twitter_api_key
   TWITTER_API_SECRET=your_twitter_api_secret
   TWITTER_ACCESS_TOKEN=your_twitter_access_token
   TWITTER_ACCESS_TOKEN_SECRET=your_twitter_access_token_secret
   

🏃‍♂️ Running the Application

1. Start the server

   cd server
   node index.js
   

2. In a new terminal, start the client

   cd client
   node index.js
   

3. Start interacting! Type your message in the command line, for example:

   Post a tweet saying "Hello from my new AI Twitter agent! #AI #TwitterBot"
   

🛠️ Project Structure

twitter-ai-agent/
├── client/                   # Client application
│   ├── index.js             # Main client file
│   ├── package.json         # Client dependencies
│   └── .env                 # Client environment variables
├── server/                  # Server application
│   ├── index.js             # Main server file
│   ├── twittertool.js       # Twitter API integration
│   ├── package.json         # Server dependencies
│   └── .env                 # Server environment variables
├── .gitignore              # Git ignore file
└── README.md               # This file

🔒 Security Considerations

• Never commit your .env files
• Keep your API keys secure
• Use environment variables for all sensitive information
• Consider implementing user authentication for production use

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📄 License

Distributed under the MIT License. See LICENSE for more information.

📧 Contact

Your Name - Adarsh Singh

Project Link: https://github.com/adarshpheonix2810/twitter-ai-agent

🙏 Acknowledgments

• Google Gemini
• Twitter API
• Model Context Protocol
• Node.js

🌟 Show your support

Give a ⭐️ if this project helped you!