{"id":30739986,"url":"https://github.com/kingabzpro/regradar","last_synced_at":"2025-10-12T06:23:20.996Z","repository":{"id":300224930,"uuid":"1005587857","full_name":"kingabzpro/RegRadar","owner":"kingabzpro","description":"RegRadar watches the worlds regulators so you dont have to.","archived":false,"fork":false,"pushed_at":"2025-06-28T06:00:37.000Z","size":96,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-28T06:17:43.177Z","etag":null,"topics":["gradio","huggingface","keywordai","mem0","openai-api","regulatory","tavily","webcrawler"],"latest_commit_sha":null,"homepage":"https://huggingface.co/spaces/kingabzpro/RegRadar","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kingabzpro.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,"zenodo":null}},"created_at":"2025-06-20T13:20:23.000Z","updated_at":"2025-06-28T06:00:40.000Z","dependencies_parsed_at":"2025-06-20T14:31:38.754Z","dependency_job_id":"8c69ce2f-ec3c-43e0-b010-b899a9580d08","html_url":"https://github.com/kingabzpro/RegRadar","commit_stats":null,"previous_names":["kingabzpro/regradar"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/kingabzpro/RegRadar","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kingabzpro%2FRegRadar","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kingabzpro%2FRegRadar/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kingabzpro%2FRegRadar/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kingabzpro%2FRegRadar/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kingabzpro","download_url":"https://codeload.github.com/kingabzpro/RegRadar/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kingabzpro%2FRegRadar/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273529532,"owners_count":25121827,"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","status":"online","status_checked_at":"2025-09-03T02:00:09.631Z","response_time":76,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["gradio","huggingface","keywordai","mem0","openai-api","regulatory","tavily","webcrawler"],"created_at":"2025-09-03T23:46:06.793Z","updated_at":"2025-10-12T06:23:15.957Z","avatar_url":"https://github.com/kingabzpro.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"---\ntitle: RegRadar\nemoji: 🛡️\ncolorFrom: blue\ncolorTo: indigo\nsdk: gradio\nsdk_version: 5.35.0\napp_file: app.py\npinned: true\nlicense: apache-2.0\nshort_description: RegRadar watches the worlds regulators so you dont have to.\n---\n\n# RegRadar\n\nRegRadar is an AI-powered regulatory compliance assistant that monitors global regulations so you don't have to. It helps compliance professionals, legal teams, and businesses stay up-to-date with the latest regulatory changes across industries and regions.\n\n[![RegRadar (100 Agents Hackathon)](./images/image.png)](https://www.youtube.com/watch?v=v0lZMx_Yt2I)\n\n## 🚀 Features\n- **Improved Regulatory Query Detection**: Now distinguishes between new regulatory/compliance/update questions and follow-up or general questions. Only new regulatory questions trigger compliance workflows; follow-ups and general queries are handled as general chat.\n- **Automatic Query Type Detection**: Understands if your message is a regulatory compliance query or a general question, and selects the right tools.\n- **Information Extraction**: Extracts key details (industry, region, keywords, and report type) from your queries for precise analysis.\n- **Smart Report Type Detection**: Automatically determines if you want a quick answer, a summary, or a full compliance report based on your query. The detected report type is shown in the parameter extraction step and controls the style and length of the AI's response.\n- **Regulatory Web Crawler**: Crawls official regulatory websites (e.g., SEC, FDA, FTC, ESMA, BIS) for recent updates and compliance changes (last 30 days).\n- **Regulatory Search Engine**: Searches across multiple sources for industry-specific compliance information and aggregates results.\n- **Memory System**: Remembers past queries and responses, personalizing results for each session/user.\n- **AI Analysis Engine**: Summarizes findings and generates actionable compliance recommendations and executive summaries.\n\n## 🚦 How It Works\nWhen you submit a query, RegRadar:\n1. Detects if your message is a **new** regulatory/compliance question (not a follow-up or general question).\n2. If yes, extracts industry, region, keywords, and report type.\n3. If no, processes your message as a general or follow-up query.\n4. Runs the appropriate regulatory search/crawl and memory lookup if regulatory.\n5. Shows the extracted parameters, including the report type, in the UI for transparency.\n5. Generates a response matching your intent:\n   - **Quick**: Direct, brief answer to specific questions.\n   - **Summary**: Short summary for summary requests.\n   - **Full**: Comprehensive report (default for vague or broad queries).\n\n## 🏁 Getting Started\n\nFollow these steps to set up and run RegRadar locally:\n\n1. **Create a virtual environment (recommended):**\n   \n   On Windows:\n   ```bash\n   python -m venv venv\n   .\\venv\\Scripts\\activate\n   ```\n   On macOS/Linux:\n   ```bash\n   python3 -m venv venv\n   source venv/bin/activate\n   ```\n\n2. **Install dependencies:**\n   ```bash\n   pip install -r requirements.txt\n   ```\n\n3. **Run the app:**\n   ```bash\n   python app.py\n   ```\n\nThe app will start and you can access it via the provided local URL in your browser.\n\n## 🔑 Setting Up API Keys\n\nBefore running RegRadar, you must set up API keys for the required services as environment variables.\n\n**On Windows (PowerShell):**\n```powershell\n$env:TAVILY_API_KEY=\"your-tavily-api-key\"\n$env:KEYWORDS_API_KEY=\"your-keywordsai-api-key\"\n$env:MEM0_API_KEY=\"your-mem0-api-key\"\n```\n\n**On macOS/Linux (bash):**\n```bash\nexport TAVILY_API_KEY=\"your-tavily-api-key\"\nexport KEYWORDS_API_KEY=\"your-keywordsai-api-key\"\nexport MEM0_API_KEY=\"your-mem0-api-key\"\n```\n\nYou can add these lines to your `.env` file or your shell profile for convenience.\n\n## 🤖 Adding Your OpenAI API Key to KeywordsAI\n\nRegRadar uses the KeywordsAI platform, which requires an OpenAI API key for LLM access. Here's how to add your OpenAI API key:\n\n1. **Get your OpenAI API key:**\n   - Go to [OpenAI Platform](https://platform.openai.com/).\n   - Log in and navigate to your profile \u003e **View API Keys**.\n   - Click **Create new secret key** and copy the generated key.\n\n2. **Add your OpenAI API key to KeywordsAI:**\n   - Log in to your KeywordsAI account.\n   - Go to the [KeywordsAI Providers page](https://platform.keywordsai.co/platform/api/providers).\n   - Find the OpenAI provider and paste your OpenAI API key into the provided field.\n   - Save your changes.\n\n\u003e For more details, see the [KeywordsAI Providers documentation](https://platform.keywordsai.co/platform/api/providers).\n\n## 🛠️ Tools Used\n- **Gradio**: For the interactive web UI.\n- **OpenAI/KeywordsAI LLM**: For natural language understanding, information extraction, summarization, and LLM tracking.\n- **Tavily**: For regulatory web crawling and search.\n- **Mem0**: For session-based memory and personalization.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkingabzpro%2Fregradar","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkingabzpro%2Fregradar","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkingabzpro%2Fregradar/lists"}