https://github.com/profullstack/botspm
AI bot management platform for conducting "lives" on TikTok, YouTube or X
https://github.com/profullstack/botspm
Last synced: 20 days ago
JSON representation
AI bot management platform for conducting "lives" on TikTok, YouTube or X
- Host: GitHub
- URL: https://github.com/profullstack/botspm
- Owner: profullstack
- License: mit
- Created: 2025-03-20T10:12:18.000Z (about 1 year ago)
- Default Branch: master
- Last Pushed: 2025-03-23T20:41:44.000Z (about 1 year ago)
- Last Synced: 2025-12-27T00:52:53.746Z (6 months ago)
- Language: JavaScript
- Size: 540 KB
- Stars: 18
- Watchers: 2
- Forks: 4
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# bots.pm
[](https://www.electronjs.org/)
[](https://nodejs.org/)
[](https://www.webcomponents.org/)
[](https://pptr.dev/)
[](https://www.sqlite.org/)
[](https://pnpm.io/)
[](https://ffmpeg.org/)
[](https://github.com/winstonjs/winston)
[](https://github.com/motdotla/dotenv)
[](https://github.com/brix/crypto-js)
A desktop application for managing multiple AI bots across streaming platforms like YouTube, TikTok, and X.com.
## Overview
bots.pm allows content creators to run multiple AI-powered bots across different streaming platforms simultaneously. Each bot can have its own unique personality, voice, and behavior, creating engaging and interactive experiences for viewers.
The application provides a unified dashboard for managing all bots, with real-time control and monitoring capabilities. It integrates with popular streaming platforms and uses advanced AI models to generate human-like responses to viewer interactions.
## Features
bots.pm offers a wide range of features, including:
- **Multi-Platform Support**: Run bots on TikTok, YouTube, and X.com simultaneously
- **Customizable Bot Personalities**: Create unique personas for each bot
- **Director Mode**: Send real-time instructions to all active bots
- **AI-Powered Responses**: Generate natural, contextually appropriate responses
- **Text-to-Speech**: Convert bot responses to natural-sounding speech
- **Stream Management**: Manage RTMP streams across platforms
- **User-Friendly Interface**: Intuitive dashboard for bot management
- **System Tray Integration**: Quick access and background operation
For a complete list of features, see [FEATURES.md](FEATURES.md).
## Installation
### Prerequisites
- Node.js (v16.0.0 or higher)
- pnpm (v8.0.0 or higher)
- FFmpeg (for audio/video processing)
### Setup
1. Clone the repository:
```bash
git clone https://github.com/yourusername/bots.pm.git
cd bots.pm
```
2. Install dependencies:
```bash
pnpm install
```
3. Create a `.env` file based on the provided `.env.sample`:
```bash
cp .env.sample .env
```
4. Run the setup script:
```bash
pnpm setup
```
5. Start the application:
```bash
pnpm dev
```
## Usage
### First-Time Setup
1. Launch the application
2. Create a user account or log in
3. Complete the initial setup wizard
4. Configure your API keys in the Settings panel
### Creating a Bot
1. Navigate to the Bots section
2. Click "Create New Bot"
3. Enter bot details (name, platform, personality)
4. Configure platform-specific settings
5. Save the bot configuration
### Running Bots
1. Select the bots you want to run
2. Click "Start Selected Bots" or "Start All Bots"
3. Monitor bot activity in the dashboard
4. Use Director Mode to send instructions to bots in real-time
## Development
### Project Structure
```
bots.pm/
├── assets/ # Application assets (icons, images)
├── bin/ # Binary scripts
├── data/ # Application data storage
├── public/ # Public static files
├── scripts/ # Utility scripts
├── src/ # Source code
│ ├── ui/ # UI components and frontend logic
│ │ ├── components/ # Web components
│ │ └── app.js # Main application logic
│ ├── main.js # Electron main process
│ ├── master.js # Bot management logic
│ └── preload.js # Electron preload script
└── config.json # Application configuration
```
### Building
To build the application for production:
```bash
pnpm build
```
This will create platform-specific builds in the `dist` directory.
### Releasing
To create a new release with binaries for all platforms:
1. Update the version in `package.json`
2. Ensure your `.env` file contains GitHub credentials:
```
GITHUB_TOKEN=your_github_personal_access_token
REPO_OWNER=yourusername
REPO_NAME=bots.pm
```
3. Run the release script:
```bash
pnpm release
```
This will:
- Build the application for Windows, macOS, and Linux
- Create a GitHub release with the current version
- Upload all binaries to the release
### Testing
To run tests:
```bash
pnpm test
```
## Contributing
Contributions are welcome! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## Acknowledgments
- [Electron](https://www.electronjs.org/) - Desktop application framework
- [OpenAI](https://openai.com/) - AI language models
- [FFmpeg](https://ffmpeg.org/) - Audio/video processing
- [Puppeteer](https://pptr.dev/) - Browser automation