{"id":37079834,"url":"https://github.com/cennest/ground-cite","last_synced_at":"2026-01-14T09:39:35.755Z","repository":{"id":313191951,"uuid":"1045445779","full_name":"cennest/ground-cite","owner":"cennest","description":"An Open Source Python package to strengthen Gemini Citations- Validated, Controlled, Reliable and Structured Citations","archived":false,"fork":false,"pushed_at":"2025-09-09T05:44:06.000Z","size":956,"stargazers_count":13,"open_issues_count":1,"forks_count":6,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-12-06T07:43:08.680Z","etag":null,"topics":["broken-citations","brokengeminicitations","gemini","gemini-404-urls","gemini-invalid-urls","googlegrounding","grounding","invalid-citations","irrelevant-citations","irrelevantgeminicitations","missinggeminicitations","structured-citations"],"latest_commit_sha":null,"homepage":"https://www.cennest.com/category/groundcite/","language":"Python","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/cennest.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-08-27T07:22:06.000Z","updated_at":"2025-12-05T15:27:46.000Z","dependencies_parsed_at":"2025-09-07T14:45:21.262Z","dependency_job_id":null,"html_url":"https://github.com/cennest/ground-cite","commit_stats":null,"previous_names":["cennest/ground-cite"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/cennest/ground-cite","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cennest%2Fground-cite","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cennest%2Fground-cite/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cennest%2Fground-cite/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cennest%2Fground-cite/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cennest","download_url":"https://codeload.github.com/cennest/ground-cite/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cennest%2Fground-cite/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28416120,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-14T08:38:59.149Z","status":"ssl_error","status_checked_at":"2026-01-14T08:38:43.588Z","response_time":107,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: 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":["broken-citations","brokengeminicitations","gemini","gemini-404-urls","gemini-invalid-urls","googlegrounding","grounding","invalid-citations","irrelevant-citations","irrelevantgeminicitations","missinggeminicitations","structured-citations"],"created_at":"2026-01-14T09:39:34.983Z","updated_at":"2026-01-14T09:39:35.751Z","avatar_url":"https://github.com/cennest.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# GroundCite - Powering Gemini with Smarter, Controlled and Reliable Grounding and Citations\n\n![Version](https://img.shields.io/badge/version-1.1.0-blue.svg)\n![Python](https://img.shields.io/badge/python-3.12%2B-blue.svg)\n![License](https://img.shields.io/badge/license-MIT-green.svg)\n\n\u003ch1\u003eFix Gemini’s Broken Citations with GroundCite\u003c/h1\u003e\n**GroundCite** is a Python library for adding better grounding and valid Citation support when searching using Gemini with google grounding . It combines web search using Gemini with google grounding with context validation, and structured data parsing using multiple AI providers to deliver accurate and reliable answers to complex questions.\n\nIf you’ve ever faced:\n\n- **Broken citations** in Gemini’s outputs,  \n- **Irrelevant/Invalid citations** pointing to 404 pages or unrelated content, or  \n- **No Citations** in Structured JSON responses,  \n- **Grounding Issues: Gemini disregarding your instructions wrt source of data** ( no inclusions or exclusions),  \nthen GroundCite is your solution.\n\n**Read more about why we made GroundCite**  https://www.cennest.com/fix-geminis-broken-citations-with-groundcite-complete-guide/\n\n**Playground app for feature testing** https://groundcite.cennest.com/  \n\n**GroundCite in Action** https://youtu.be/b1sCCRSgi38\n\n## 🚀 Features\n\n### Core Capabilities\n- **Intelligent Search Integration**: Intelligent grounding search with site filtering and content aggregation\n- **AI-Powered Validation**: Optional citation validation using advanced AI models\n- **Structured Data Parsing with Citation**: Extract structured data with Citations using custom JSON schemas\n- **MultiAgent Graph-Based Pipeline**: Consistent output with automatic retry logic and error handling\n- **Comprehensive Logging**: Detailed execution metrics and token usage tracking\n\n### Interface Options\n- **Command Line Interface (CLI)**: Feature-rich CLI with rich text formatting\n- **REST API**: FastAPI-based web service for HTTP integration\n- **Python Library**: Direct integration into Python applications\n\n### Advanced Features\n- **Retry Logic**: Robust error handling with configurable retry mechanisms\n- **Token Usage Tracking**: Monitor AI service consumption and costs\n- **Correlation Tracking**: End-to-end request tracing and debugging\n- **Configuration Management**: Flexible settings with validation\n- **Site Filtering**: Include/exclude specific domains in search results\n\n### FAQs\nhttps://www.cennest.com/groundcite-frequently-asked-questions-faq/\n\n\n### Detailed Architecture and usage\n-https://github.com/cennest/ground-cite/blob/main/GroundCite/docs/ARCHITECTURE.md\u003c/br\u003e\n-https://github.com/cennest/ground-cite/blob/main/GroundCite/docs/ARCHITECTURE_LIGHT.md\u003c/br\u003e\n-https://github.com/cennest/ground-cite/blob/main/GroundCite/docs/USAGE.md\n- **Detailed Documentation**: [Full documentation](https://github.com/cennest/ground-cite/tree/main/GroundCite/docs)\n\n## 📋 Requirements\n\n- **Python**: 3.12 or higher\n- **Dependencies**: See [requirements.txt](requirements.txt) for full list\n\n### Key Dependencies\n- `langgraph` - Graph-based workflow orchestration\n- `google-genai` - Google Gemini AI integration\n- `openai` - OpenAI API integration\n- `fastapi` - REST API framework\n- `click` - CLI framework\n- `rich` - Enhanced terminal output\n- `pydantic` - Data validation and settings\n\n## 🔧 Installation\n\n### From Source\n```bash\ngit clone https://github.com/cennest/ground-cite.git\ncd ground-cite/GroundCite\npip install -e .\n```\n\n### Using pip (when published)\n```bash\npip install gemini-groundcite\n```\n\n## ⚡ Quick Start\n\n### 1. Basic CLI Usage\n\n```bash\n# Simple query analysis\ngemini-groundcite analyze -q \"What are the latest developments in AI?\" --gemini-key your_gemini_key\n\n# With validation and parsing\ngemini-groundcite analyze -q \"Company X financials\" --validate --parse --gemini-key your_gemini_key\n\n# Using OpenAI provider\ngemini-groundcite analyze -q \"Market trends\" --provider openai --openai-key your_key --gemini-key your_gemini_key\n```\n\n### 2. Python Library Usage\n\n```python\nfrom gemini_groundcite.config.settings import AppSettings\nfrom gemini_groundcite.core.agents import AIAgent\n\n# Configure settings\nsettings = AppSettings()\nsettings.ANALYSIS_CONFIG.query = \"What are quantum computing breakthroughs?\"\nsettings.ANALYSIS_CONFIG.validate = True\nsettings.ANALYSIS_CONFIG.parse = True\nsettings.AI_CONFIG.gemini_ai_key_primary = \"your_gemini_key\"\n\n# Initialize and run analysis\nagent = AIAgent(settings=settings)\nresults = await agent.analyze_query()\n\nprint(f\"Analysis completed: {results['completed']}\")\nprint(f\"Results: {results['final_content']}\")\n```\n\n### 3. REST API Usage\n\n```bash\n# Start the API server\npython -m gemini_groundcite.main\n\n# Make analysis requests\ncurl -X POST \"http://localhost:8000/api/v1/analyze\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"query\": \"Latest AI developments\",\n    \"config\": {\"validate\": true, \"parse\": true},\n    \"search_model_name\": \"gemini-2.5-flash\",\n    \"api_keys\": {\"gemini\": {\"primary\": \"your_key\"}}\n  }'\n```\n\n## 🤝 Contributing\n\nWe welcome contributions! Please reach out to anshulee@cennest.com or even better send us a PR..\n\n### Development Setup\n```bash\n# Clone the repository\ngit clone https://github.com/cennest/ground-cite.git\ncd ground-cite/GroundCite\n\n# Create virtual environment\npython -m venv venv\nsource venv/bin/activate  # On Windows: venv\\Scripts\\activate\n\n# Install in development mode\npip install -e \".[dev]\"\n\n```\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 📞 Support\n\n- **GitHub Issues**: [Report bugs and request features](https://github.com/cennest/ground-cite/issues)\n- **Email**: anshulee@cennest.com\n\n## 🏆 Acknowledgments\n\n- Built with [LangGraph](https://github.com/langchain-ai/langgraph) for workflow orchestration\n- Powered by Google Gemini and OpenAI APIs\n- CLI interface built with [Click](https://click.palletsprojects.com/) and [Rich](https://rich.readthedocs.io/)\n- Web API built with [FastAPI](https://fastapi.tiangolo.com/)\n\n---\n\n**GroundCite** - *Empowering intelligent query analysis with AI*\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcennest%2Fground-cite","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcennest%2Fground-cite","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcennest%2Fground-cite/lists"}