{"id":26678133,"url":"https://github.com/telexintegrations/socialmediaagent","last_synced_at":"2025-03-26T05:14:59.864Z","repository":{"id":281947351,"uuid":"946938977","full_name":"telexintegrations/SocialMediaAgent","owner":"telexintegrations","description":"An integration that generates AI-powered social media posts with content, hashtags, and media suggestions based on trending topics.","archived":false,"fork":false,"pushed_at":"2025-03-20T11:44:11.000Z","size":46,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-20T12:45:04.583Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/telexintegrations.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2025-03-11T23:04:48.000Z","updated_at":"2025-03-20T11:39:42.000Z","dependencies_parsed_at":null,"dependency_job_id":"c99c65ab-e447-4222-9e75-a83bee44e5fe","html_url":"https://github.com/telexintegrations/SocialMediaAgent","commit_stats":null,"previous_names":["telexintegrations/socialmediaagent"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/telexintegrations%2FSocialMediaAgent","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/telexintegrations%2FSocialMediaAgent/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/telexintegrations%2FSocialMediaAgent/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/telexintegrations%2FSocialMediaAgent/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/telexintegrations","download_url":"https://codeload.github.com/telexintegrations/SocialMediaAgent/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245591534,"owners_count":20640692,"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":"2025-03-26T05:14:59.167Z","updated_at":"2025-03-26T05:14:59.837Z","avatar_url":"https://github.com/telexintegrations.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"---\n\n# 📢 **Social Media Content Generator**\n\nAI-powered tool to generate and post social media content directly to Telex channels. The system integrates **Groq AI** for content generation and **Telex** for content distribution, enabling businesses to automate the process of creating engaging social media posts.\n\n---\n\n## 🚀 **Overview**\n\nThe **Social Media Content Generator** automates the process of generating social media posts based on user-defined keywords or prompts. This integration uses **Groq AI** for content generation and sends the results to a **Telex channel**. The tool allows users to generate, customize, and post content to various platforms, streamlining social media management.\n\n---\n\n## ✨ **Features**\n\n✅ **Groq AI Integration** - Automatically generates social media content based on a user-provided prompt (e.g., \"Product Launch Announcement\").  \n✅ **Telex Channel Integration** - Sends the generated content to a Telex channel for easy sharing and management.  \n✅ **Customizable AI Content** - Users can specify the tone, style, audience, and purpose for more tailored social media posts.  \n✅ **Content Preview** - A preview of generated posts is displayed in the Telex channel before posting.  \n✅ **Error Handling** - The system handles errors like empty or invalid prompts and notifies users accordingly.  \n\n---\n\n## 📌 **Tech Stack**\n\n- **Backend**: ASP.NET Core, C#\n- **API \u0026 Integration**: Groq API, Telex API\n- **HTTP Client**: `HttpClient` for external requests\n- **Configuration**: `appsettings.json` for app settings and API configurations\n\n---\n\n## 🛠 **Installation Guide**\n\n### 1️⃣ **Clone the Repository**\n\n```bash\ngit clone https://github.com/your-username/social-media-content-generator.git\ncd social-media-content-generator\n```\n\n### 2️⃣ **Install Dependencies**\n\nRestore and install the required dependencies:\n\n```bash\ndotnet restore\n```\n\n### 3️⃣ **Set Up AppSettings**\n\nIn the `appsettings.json` file, add the following sections for **Groq API** and **Telex** integration settings:\n\n```json\n{\n  \"GroqConfig\": {\n    \"ApiKey\": \"your_groq_api_key\", // Add your Groq API key here\n    \"ApiUrl\": \"https://api.groq.com/openai/v1/chat/completions\" // The Groq API URL\n  },\n  \"TelexConfig\": {\n    \"data\": {\n      \"target_url\": \"your_telex_webhook_url\" // Add your Telex webhook URL here\n    }\n  }\n}\n```\n\n- Replace `\"your_groq_api_key\"` with your actual Groq API key.\n- Replace `\"your_telex_webhook_url\"` with the **Telex webhook URL** where the generated content will be sent.\n\n### 4️⃣ **Telex Integration Setup**\n\nTo complete the **Telex** integration:\n\n- Add the **URL of your deployed app** (which will contain the `integration.json`) to the **Telex channel** configuration.\n- Ensure that the **Webhook URL** from Telex is added to the `target_url` in the `TelexConfig` section of your `appsettings.json`.\n- Specify the **number of responses** you want from the AI directly in the request or configuration.\n\n### 5️⃣ **Start the Application**\n\nRun the following command to start the application:\n\n```bash\ndotnet run\n```\n\n---\n\n## 👨‍💻 **Usage**\n\n- **Generate Social Media Post**: To generate a post, send a request with a prompt (e.g., `/generate-post \"Product Launch Announcement\"`) to the Telex channel.\n- **Schedule Posts**: You can schedule posts for future publication within the Telex channel using specific commands and set times.\n- **Customize Content**: Specify tone, style, audience, and post purpose to generate customized content for your social media.\n\n---\n\n## 📂 **Folder Structure**\n\n```\n├── Controllers\n│   ├── TelexController.cs\n│   └── GroqController.cs\n├── Models\n│   ├── Request\n│   │   └── GroqPromptRequest.cs\n│   ├── Response\n│   │   └── TelexMessageResponse.cs\n├── Repositories\n│   ├── Interfaces\n│   │   └── ITelexService.cs\n│   └── Implementation\n│       └── TelexRepository.cs\n├── Services\n│   └── GroqService.cs\n└── appsettings.json\n```\n\n---\n\n## 🔧 **Contributing**\n\n1. **Fork the Repository**  \n   Fork the project repository to your own GitHub account.\n\n2. **Create a Branch**  \n   Create a new branch for your feature or bugfix:\n\n   ```bash\n   git checkout -b feature/branch-name\n   ```\n\n3. **Commit Changes**  \n   Commit your changes with descriptive messages:\n\n   ```bash\n   git commit -m \"Added new feature\"\n   ```\n\n4. **Push Changes**  \n   Push the changes to your forked repository:\n\n   ```bash\n   git push origin feature/branch-name\n   ```\n\n5. **Create a Pull Request**  \n   Open a pull request (PR) to the original repository from your fork.\n\n---\n\n## 🙋‍♂️ **Questions or Issues?**\n\nFeel free to reach out with any questions or open an issue if something isn't working as expected.\n\n---\n\n### Notes:\n- This README outlines the setup and integration steps for a project that automatically generates and posts social media content using **Groq AI** and **Telex** integration.\n- It includes instructions for setting up the **Groq API** and **Telex Webhook**, which are crucial for the system to work correctly.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftelexintegrations%2Fsocialmediaagent","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftelexintegrations%2Fsocialmediaagent","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftelexintegrations%2Fsocialmediaagent/lists"}