{"id":34106625,"url":"https://github.com/nblx-org/authring","last_synced_at":"2026-04-10T05:55:35.417Z","repository":{"id":280068187,"uuid":"940893157","full_name":"Nblx-org/authring","owner":"Nblx-org","description":"Authring is an AI-driven guardrails system that evaluates code change requests using Astra DB, Langflow, Unstructured.io, and Twilio. ","archived":false,"fork":false,"pushed_at":"2025-03-02T07:02:17.000Z","size":107,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-23T13:20:47.614Z","etag":null,"topics":["agentic-workflow","astradb","automation","devops","guardrails","langflow","machine-learning","twilio","unstructured"],"latest_commit_sha":null,"homepage":"https://authring.org","language":"CSS","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/Nblx-org.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-01T02:12:11.000Z","updated_at":"2025-03-02T07:02:20.000Z","dependencies_parsed_at":"2025-03-01T03:29:38.305Z","dependency_job_id":null,"html_url":"https://github.com/Nblx-org/authring","commit_stats":null,"previous_names":["nblx-org/authring"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Nblx-org/authring","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nblx-org%2Fauthring","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nblx-org%2Fauthring/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nblx-org%2Fauthring/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nblx-org%2Fauthring/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Nblx-org","download_url":"https://codeload.github.com/Nblx-org/authring/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nblx-org%2Fauthring/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":27630440,"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-12-10T02:00:12.818Z","response_time":54,"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":["agentic-workflow","astradb","automation","devops","guardrails","langflow","machine-learning","twilio","unstructured"],"created_at":"2025-12-14T18:02:56.359Z","updated_at":"2025-12-14T18:03:53.053Z","avatar_url":"https://github.com/Nblx-org.png","language":"CSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Authring\n\n[![PyPI version](https://img.shields.io/pypi/v/authring.svg)](https://pypi.org/project/authring/)\n\nAuthring is an MCP-driven guardrails system that evaluates code modification proposals based on historical impact, contributor expertise, and production risk assessment. The system utilizes:\n\n- **Astra DB** for historical data storage\n- **Unstructured.io** for document parsing\n- **Langflow** for AI-driven decision-making\n- **Twilio** for real-time human validation\n- **GitHub CLI (gh)** for managing patch review links\n\n## Workflow\n1. **MCP Server** receives a proposed patch in the format:\n   ```json\n   {\n       \"repo\": \"flight-control\",\n       \"purpose\": \"Fix typo in logging message\",\n       \"patch\": \"diff --git a/utils/logger.py b/utils/logger.py\\n- log.info('Engne diagnostics running')\\n+ log.info('Engine diagnostics running')\"\n   }\n   ```\n2. **Contextualization**: The system extracts metadata from `mock/code/` to determine the impact, authorship, and production status of the affected code.\n3. **Risk Assessment**:\n   - If **Safe**, the patch is accepted.\n   - If **Unsafe**, the patch is rejected.\n   - If **Maybe**, a **Twilio notification** is sent to the responsible contributor.\n4. **Twilio Review (Maybe Cases)**:\n   - The contributor receives a text:\n     ```\n     Authring wants to 'Improve flight path prediction' by changing 'navigation.py'.\n     Review it here: \u003cGitHub Gist Link\u003e and respond with your recommendation.\n     ```\n   - The system waits for a response (15s timeout) before making a final decision.\n\n## Demo Scenarios\n- ✅ **Valid Purpose, Valid Patch**: Fix typo in `logger.py`.\n- ❌ **Invalid Purpose**: Replace autopilot with `YOLO()` function.\n- ⚠️ **Valid Purpose, Invalid Patch**: Change flight path prediction logic (triggers Twilio).\n\n## Setup\n```sh\npython3 -m venv venv\nsource venv/bin/activate\npip install -r requirements.txt\npython mcp_server.py\n```\n\n## Running the Demo\n```sh\npython train.py  # Populate mock Astra DB with training data\npython mcp_server.py  # Start the evaluation pipeline\n```\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnblx-org%2Fauthring","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnblx-org%2Fauthring","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnblx-org%2Fauthring/lists"}