{"id":34827424,"url":"https://github.com/profullstack/botspm","last_synced_at":"2026-05-25T04:34:55.658Z","repository":{"id":283459655,"uuid":"951834299","full_name":"profullstack/botspm","owner":"profullstack","description":"AI bot management platform for conducting \"lives\" on TikTok, YouTube or X","archived":false,"fork":false,"pushed_at":"2025-03-23T20:41:44.000Z","size":553,"stargazers_count":18,"open_issues_count":1,"forks_count":4,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-12-27T00:52:53.746Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/profullstack.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-03-20T10:12:18.000Z","updated_at":"2025-12-20T21:44:13.000Z","dependencies_parsed_at":"2025-03-20T11:27:56.270Z","dependency_job_id":"828f23b8-abbc-4898-8fca-f5459441fbbc","html_url":"https://github.com/profullstack/botspm","commit_stats":null,"previous_names":["profullstack/botspm"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/profullstack/botspm","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/profullstack%2Fbotspm","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/profullstack%2Fbotspm/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/profullstack%2Fbotspm/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/profullstack%2Fbotspm/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/profullstack","download_url":"https://codeload.github.com/profullstack/botspm/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/profullstack%2Fbotspm/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33461090,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-25T02:24:28.008Z","status":"ssl_error","status_checked_at":"2026-05-25T02:23:23.339Z","response_time":57,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-12-25T15:21:27.857Z","updated_at":"2026-05-25T04:34:55.652Z","avatar_url":"https://github.com/profullstack.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# bots.pm\n\n![bots.pm Logo](public/logo.bots.black.svg)\n\n[![Electron](https://img.shields.io/badge/Electron-47848F?logo=electron\u0026logoColor=fff\u0026style=for-the-badge)](https://www.electronjs.org/)\n[![Node.js](https://img.shields.io/badge/Node.js-339933?logo=nodedotjs\u0026logoColor=fff\u0026style=for-the-badge)](https://nodejs.org/)\n[![Web Components](https://img.shields.io/badge/Web%20Components-29ABE2?logo=webcomponents.org\u0026logoColor=fff\u0026style=for-the-badge)](https://www.webcomponents.org/)\n[![Puppeteer](https://img.shields.io/badge/Puppeteer-40B5A4?logo=puppeteer\u0026logoColor=fff\u0026style=for-the-badge)](https://pptr.dev/)\n[![SQLite](https://img.shields.io/badge/SQLite-003B57?logo=sqlite\u0026logoColor=fff\u0026style=for-the-badge)](https://www.sqlite.org/)\n[![pnpm](https://img.shields.io/badge/pnpm-F69220?logo=pnpm\u0026logoColor=fff\u0026style=for-the-badge)](https://pnpm.io/)\n[![FFmpeg](https://img.shields.io/badge/FFmpeg-007808?logo=ffmpeg\u0026logoColor=fff\u0026style=for-the-badge)](https://ffmpeg.org/)\n[![Winston](https://img.shields.io/badge/Winston-231F20?logo=winston\u0026logoColor=fff\u0026style=for-the-badge)](https://github.com/winstonjs/winston)\n[![dotenv](https://img.shields.io/badge/dotenv-ECD53F?logo=dotenv\u0026logoColor=000\u0026style=for-the-badge)](https://github.com/motdotla/dotenv)\n[![CryptoJS](https://img.shields.io/badge/CryptoJS-000000?logo=crypto\u0026logoColor=fff\u0026style=for-the-badge)](https://github.com/brix/crypto-js)\n\nA desktop application for managing multiple AI bots across streaming platforms like YouTube, TikTok, and X.com.\n\n## Overview\n\nbots.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.\n\nThe 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.\n\n## Features\n\nbots.pm offers a wide range of features, including:\n\n- **Multi-Platform Support**: Run bots on TikTok, YouTube, and X.com simultaneously\n- **Customizable Bot Personalities**: Create unique personas for each bot\n- **Director Mode**: Send real-time instructions to all active bots\n- **AI-Powered Responses**: Generate natural, contextually appropriate responses\n- **Text-to-Speech**: Convert bot responses to natural-sounding speech\n- **Stream Management**: Manage RTMP streams across platforms\n- **User-Friendly Interface**: Intuitive dashboard for bot management\n- **System Tray Integration**: Quick access and background operation\n\nFor a complete list of features, see [FEATURES.md](FEATURES.md).\n\n## Installation\n\n### Prerequisites\n\n- Node.js (v16.0.0 or higher)\n- pnpm (v8.0.0 or higher)\n- FFmpeg (for audio/video processing)\n\n### Setup\n\n1. Clone the repository:\n   ```bash\n   git clone https://github.com/yourusername/bots.pm.git\n   cd bots.pm\n   ```\n\n2. Install dependencies:\n   ```bash\n   pnpm install\n   ```\n\n3. Create a `.env` file based on the provided `.env.sample`:\n   ```bash\n   cp .env.sample .env\n   ```\n\n4. Run the setup script:\n   ```bash\n   pnpm setup\n   ```\n\n5. Start the application:\n   ```bash\n   pnpm dev\n   ```\n\n## Usage\n\n### First-Time Setup\n\n1. Launch the application\n2. Create a user account or log in\n3. Complete the initial setup wizard\n4. Configure your API keys in the Settings panel\n\n### Creating a Bot\n\n1. Navigate to the Bots section\n2. Click \"Create New Bot\"\n3. Enter bot details (name, platform, personality)\n4. Configure platform-specific settings\n5. Save the bot configuration\n\n### Running Bots\n\n1. Select the bots you want to run\n2. Click \"Start Selected Bots\" or \"Start All Bots\"\n3. Monitor bot activity in the dashboard\n4. Use Director Mode to send instructions to bots in real-time\n\n## Development\n\n### Project Structure\n\n```\nbots.pm/\n├── assets/            # Application assets (icons, images)\n├── bin/               # Binary scripts\n├── data/              # Application data storage\n├── public/            # Public static files\n├── scripts/           # Utility scripts\n├── src/               # Source code\n│   ├── ui/            # UI components and frontend logic\n│   │   ├── components/  # Web components\n│   │   └── app.js       # Main application logic\n│   ├── main.js        # Electron main process\n│   ├── master.js      # Bot management logic\n│   └── preload.js     # Electron preload script\n└── config.json        # Application configuration\n```\n\n### Building\n\nTo build the application for production:\n\n```bash\npnpm build\n```\n\nThis will create platform-specific builds in the `dist` directory.\n\n### Releasing\n\nTo create a new release with binaries for all platforms:\n\n1. Update the version in `package.json`\n2. Ensure your `.env` file contains GitHub credentials:\n   ```\n   GITHUB_TOKEN=your_github_personal_access_token\n   REPO_OWNER=yourusername\n   REPO_NAME=bots.pm\n   ```\n3. Run the release script:\n   ```bash\n   pnpm release\n   ```\n\nThis will:\n- Build the application for Windows, macOS, and Linux\n- Create a GitHub release with the current version\n- Upload all binaries to the release\n\n### Testing\n\nTo run tests:\n\n```bash\npnpm test\n```\n\n## Contributing\n\nContributions are welcome! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## Acknowledgments\n\n- [Electron](https://www.electronjs.org/) - Desktop application framework\n- [OpenAI](https://openai.com/) - AI language models\n- [FFmpeg](https://ffmpeg.org/) - Audio/video processing\n- [Puppeteer](https://pptr.dev/) - Browser automation","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprofullstack%2Fbotspm","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fprofullstack%2Fbotspm","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprofullstack%2Fbotspm/lists"}