{"id":21335152,"url":"https://github.com/pollinations/digitaltwin","last_synced_at":"2025-08-30T14:03:59.847Z","repository":{"id":224437830,"uuid":"763239230","full_name":"pollinations/digitaltwin","owner":"pollinations","description":null,"archived":false,"fork":false,"pushed_at":"2024-09-22T13:35:59.000Z","size":2623,"stargazers_count":2,"open_issues_count":1,"forks_count":1,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-07-04T16:56:29.374Z","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/pollinations.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"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":"2024-02-25T22:32:42.000Z","updated_at":"2025-04-22T01:08:52.000Z","dependencies_parsed_at":"2024-03-17T19:28:31.727Z","dependency_job_id":"c987c68e-5061-4438-a534-982121c3dd42","html_url":"https://github.com/pollinations/digitaltwin","commit_stats":null,"previous_names":["pollinations/digitaltwin"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/pollinations/digitaltwin","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pollinations%2Fdigitaltwin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pollinations%2Fdigitaltwin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pollinations%2Fdigitaltwin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pollinations%2Fdigitaltwin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pollinations","download_url":"https://codeload.github.com/pollinations/digitaltwin/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pollinations%2Fdigitaltwin/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264990555,"owners_count":23694450,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":"2024-11-21T23:39:35.085Z","updated_at":"2025-07-16T04:39:51.747Z","avatar_url":"https://github.com/pollinations.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Pollinations Digital Twin\n\nPollinations Digital Twin is a WhatsApp bot powered by OpenAI's cutting-edge GPT-4 Turbo Preview model, designed to engage users in conversations through text and audio messages. Drawing inspiration from the unique character of Portrait XO A.I., this bot offers whimsical and thought-provoking interactions, ensuring each conversation is distinct and memorable.\n\n## Features\n\n- **Text and Audio Processing**: Skillfully manages both text and audio inputs, effortlessly transforming audio messages into text for advanced processing.\n- **Dynamic Conversations**: Utilizes the sophisticated capabilities of the GPT-4 Turbo Preview model to craft responses that are customized for each user's input, fostering dynamic and captivating conversations.\n- **Audio Generation**: Boasts integrated capabilities for music creation and text-to-speech, enhancing user interactions with engaging audio effects.\n- **Environment and Persona Customization**: Enables precise, environment-specific settings through `.env` files, with improved security by excluding `.env*` files from version control. Additionally, it supports persona customization, allowing the bot to adopt various personalities as defined in `src/persona.js`, offering a more tailored and versatile user experience.\n\n## Setup\n\n1. **Clone the Repository**\n\n```bash\ngit clone https://github.com/your-repository/pollinations-digitaltwin.git\n```\n\n\n2. **Install Dependencies**\n\n   Navigate to the project directory and install the required npm packages:\n\n```bash\nnpm install\n```\n\n3. **Configure Environment Variables**\n\n   Create a `.env` file in the root directory and populate it with the necessary API keys and configurations as shown in `config.env`.\n\n4. **Start the Application**\n\n   Run the application using the npm start script defined in `package.json`:\n\n```bash\nnpm start\n```\n\n\n## Usage\n\nAfter starting the application, it listens for incoming WhatsApp messages. Users can interact with the bot by sending text or audio messages to the configured WhatsApp number. The bot processes these inputs and responds with text and optionally generated audio content.\n\n## Development\n\n- **Adding New Features**: Extend the bot's capabilities by modifying `index.js` and the modules in the `lib` directory.\n- **Customizing Responses**: Adjust the system prompt in the `.env` file to change the bot's personality and response style.\n\n## Contributing\n\nContributions are welcome! Please fork the repository and submit pull requests with your proposed changes.\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpollinations%2Fdigitaltwin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpollinations%2Fdigitaltwin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpollinations%2Fdigitaltwin/lists"}