{"id":34085336,"url":"https://github.com/zloeber/terraform-ingest","last_synced_at":"2026-02-20T01:01:11.373Z","repository":{"id":320128028,"uuid":"1077054197","full_name":"zloeber/terraform-ingest","owner":"zloeber","description":"A terraform multi-repo module AI RAG ingestion engine and MCP server","archived":false,"fork":false,"pushed_at":"2025-11-03T20:09:47.000Z","size":779,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-12-16T15:41:16.115Z","etag":null,"topics":["python","terraform"],"latest_commit_sha":null,"homepage":"https://zloeber.github.io/terraform-ingest/","language":"Python","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/zloeber.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","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,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null},"funding":{"github":["zloeber"]}},"created_at":"2025-10-15T17:55:57.000Z","updated_at":"2025-11-30T19:18:19.000Z","dependencies_parsed_at":"2025-12-14T13:02:53.276Z","dependency_job_id":null,"html_url":"https://github.com/zloeber/terraform-ingest","commit_stats":null,"previous_names":["zloeber/terraform-ingest"],"tags_count":22,"template":false,"template_full_name":null,"purl":"pkg:github/zloeber/terraform-ingest","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zloeber%2Fterraform-ingest","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zloeber%2Fterraform-ingest/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zloeber%2Fterraform-ingest/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zloeber%2Fterraform-ingest/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zloeber","download_url":"https://codeload.github.com/zloeber/terraform-ingest/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zloeber%2Fterraform-ingest/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29637914,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-19T22:32:43.237Z","status":"ssl_error","status_checked_at":"2026-02-19T22:32:38.330Z","response_time":117,"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":["python","terraform"],"created_at":"2025-12-14T13:02:23.949Z","updated_at":"2026-02-20T01:01:11.309Z","avatar_url":"https://github.com/zloeber.png","language":"Python","funding_links":["https://github.com/sponsors/zloeber"],"categories":[],"sub_categories":[],"readme":"\u003c!-- mcp-name: io.github.zloeber/terraform-ingest --\u003e\n# Terraform Ingest\n\nA Terraform RAG ingestion engine that accepts a YAML file of terraform git repository sources, downloads them locally using existing credentials, creates JSON summaries of their purpose, inputs, outputs, and providers for branches or tagged releases you specify and embeds them into a vector database for similarity searches. Includes an easy to use cli, API, or MCP server.\n\n## Features\n\n- 📥 **Multi-Repository Ingestion**: Process multiple Terraform repositories from a single YAML configuration\n- 🔄 **Auto-Import**: Import repositories from GitHub organizations and GitLab groups (Bitbucket support coming soon)\n- 🔍 **Comprehensive Analysis**: Extracts variables, outputs, providers, modules, and descriptions\n- 🏷️ **Branch \u0026 Tag Support**: Analyzes both branches and git tags of your choosing\n- 🔌 **Dual Interface**: Use as a CLI tool (Click) or as a REST API service (FastAPI)\n- 🤖 **MCP Integration**: MCP service for AI agent access to ingested modules via STDIO, SSE, or Streamable-http\n- 📊 **JSON Output**: Generates structured JSON summaries ready for RAG ingestion\n- 🔐 **Credential Support**: Uses existing git credentials for private repositories\n- 🧠 **Vector Database Embeddings**: Semantic search with ChromaDB, OpenAI, Claude, or sentence-transformers\n\nFurther documentation found [here](https://zloeber.github.io/terraform-ingest/)\n\nOr, if you just want the TLDR on using this as an MCP server (along with some examples) check [this](./docs/mcp_use_examples.md) out.\n\nAn example project repo with a large list of custom modules for kicking the tires can be found [here](https://github.com/zloeber/terraform-ingest-example)\n\n## Installation\n\nThis application can be run locally using uv or docker.\n\n\u003e **NOTE** `uv` is required for lazy-loading some large dependencies.\n\n```bash\nuv tool install terraform-ingest\n\n# Create a config\nuv run terraform-ingest init config.yaml\n\n# Or import repositories from a GitHub organization\nuv run terraform-ingest import github --org terraform-aws-modules --terraform-only\n\n# Or import repositories from a GitLab group\nuv run terraform-ingest import gitlab --group mygroup --recursive --terraform-only\n\n# Update your config.yaml file to include your terraform module information and mcp config then preform the initial ingestion\nuv run terraform-ingest ingest config.yaml\n\n# Run a quick cli search to test things out\nuv run terraform-ingest search \"vpc module for aws\"\n\n## Docker\ndocker pull ghcr.io/zloeber/terraform-ingest:latest\n\n# Run with volume mount for persistence, ingest modules from local config.yaml file\ndocker run -v $(pwd)/repos:/app/repos -v $(pwd)/output:/app/output -v $(pwd)/config.yaml:/app/config.yaml ghcr.io/zloeber/terraform-ingest:latest ingest /app/config.yaml\n\n# Run as MCP server\ndocker run -v $(pwd)/repos:/app/repos -v $(pwd)/output:/app/output -v $(pwd)/config.yaml:/app/config.yaml -p 8000:8000 ghcr.io/zloeber/terraform-ingest:latest mcp -c /app/config.yaml\n\n# Search for modules and get the first result, show all details\nterraform-ingest search \"vpc module for aws\" -l 1 -j | jq -r '.results[0].id' | xargs -I {} terraform-ingest index get {}\n```\n\n## License\n\nMIT License\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzloeber%2Fterraform-ingest","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzloeber%2Fterraform-ingest","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzloeber%2Fterraform-ingest/lists"}