{"id":27979183,"url":"https://github.com/kdcllc/agentic-ai-github-stars","last_synced_at":"2025-07-06T07:08:36.779Z","repository":{"id":290657662,"uuid":"975182243","full_name":"kdcllc/agentic-ai-github-stars","owner":"kdcllc","description":"Discover and leverage the power of AI to analyze and enhance GitHub repositories. This Python-based project offers seamless tools and insights tailored for developers and organizations looking to optimize their projects' visibility and performance. With a focus on simplicity and automation, this repository empowers users to track, analyze, and grow","archived":false,"fork":false,"pushed_at":"2025-05-02T00:18:25.000Z","size":15737,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-06-30T03:57:32.941Z","etag":null,"topics":["ai-tools","automation","developer-tools","github-analytics","open-source","python","repository-optimization"],"latest_commit_sha":null,"homepage":"","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/kdcllc.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}},"created_at":"2025-04-29T23:13:47.000Z","updated_at":"2025-06-03T09:58:57.000Z","dependencies_parsed_at":"2025-04-30T00:36:21.461Z","dependency_job_id":null,"html_url":"https://github.com/kdcllc/agentic-ai-github-stars","commit_stats":null,"previous_names":["kdcllc/agentic-ai-github-stars"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/kdcllc/agentic-ai-github-stars","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kdcllc%2Fagentic-ai-github-stars","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kdcllc%2Fagentic-ai-github-stars/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kdcllc%2Fagentic-ai-github-stars/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kdcllc%2Fagentic-ai-github-stars/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kdcllc","download_url":"https://codeload.github.com/kdcllc/agentic-ai-github-stars/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kdcllc%2Fagentic-ai-github-stars/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":263861996,"owners_count":23521357,"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":["ai-tools","automation","developer-tools","github-analytics","open-source","python","repository-optimization"],"created_at":"2025-05-08T02:03:49.229Z","updated_at":"2025-07-06T07:08:36.772Z","avatar_url":"https://github.com/kdcllc.png","language":"Python","funding_links":["https://www.buymeacoffee.com/vyve0og"],"categories":["python","open-source"],"sub_categories":[],"readme":"# GitHub Stars Analyzer\n\nAI Agent that fetches your GitHub starred repositories, reads their README files, and creates summaries of technologies used and primary goals.\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://github.com/kdcllc/agentic-ai-github-stars/blob/main/LICENSE)\n\n![I stand with Israel](./images/IStandWithIsrael.png)\n\n## Hire Me\n\nPlease send [email](mailto:kingdavidconsulting@gmail.com) if you consider hiring me.\n\n[![buymeacoffee](https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png)](https://www.buymeacoffee.com/vyve0og)\n\n## Give a Star! :star:\n\nIf you like or are using this project to learn or start your solution, please give it a star. Thanks!\n\n## Features\n\n- Fetch all starred repositories for a GitHub user\n- Download and parse README.md files from each repository\n- Generate AI-powered summaries of each repository including:\n  - List of technologies/frameworks used\n  - Primary goal or purpose of the repository\n- Semantic search through your starred repositories\n- Web UI for easy interaction (Streamlit)\n- Output results to a JSON file for further processing\n\n## Requirements\n\n- Python 3.7+\n- GitHub Personal Access Token (for API rate limits)\n- One of the following AI providers for generating summaries:\n  - OpenAI API Key\n  - Azure OpenAI API Key and Endpoint\n  - Ollama (running locally or on a server)\n  \n## Embedding Providers\n\nThe application supports multiple embedding providers that can work in a Docker container without GPU:\n\n1. **Sentence Transformer (CPU)** - Default option, runs entirely locally on CPU\n2. **OpenAI** - Uses OpenAI's embedding API\n3. **Azure OpenAI** - Uses Azure OpenAI's embedding API  \n4. **Ollama** - Uses local Ollama instance for embeddings\n\n### Testing Embedding Providers\n\nYou can test different embedding providers using the `test_embeddings.py` script:\n\n```powershell\n# Test with the default Sentence Transformer provider (CPU-only)\npython test_embeddings.py --provider sentence_transformer\n\n# Test with OpenAI\npython test_embeddings.py --provider openai --api_key \"your_api_key\"\n\n# Test with Azure OpenAI\npython test_embeddings.py --provider azure --endpoint \"https://your-endpoint.openai.azure.com/\" --deployment \"your_deployment\" --api_key \"your_api_key\"\n\n# Test with Ollama\npython test_embeddings.py --provider ollama --host \"http://localhost:11434\" --model \"llama3\"\n```\n\nThe embedding manager can be configured in the web UI or through environment variables when running in Docker.\n\n## Installation\n\n1. Clone this repository\n2. Install dependencies using UV (recommended):\n\n```powershell\n# Install all dependencies from pyproject.toml\nuv sync\n```\n\n## Using the Web UI\n\nThe application provides a user-friendly web interface built with Streamlit. To start the UI:\n\n```powershell\n# Or directly with streamlit\nuv run streamlit run streamlit_app.py\n```\n\nThe web UI provides:\n- Interactive form for fetching and analyzing GitHub stars\n- Real-time progress tracking during processing\n- Semantic search with detailed repository information\n- Export functionality with statistics\n- Support for all AI provider options\n\n## Docker Deployment\n\nFor running in Docker without GPU, see [DOCKER.md](DOCKER.md) for detailed instructions.\n\nQuick start:\n```bash\ndocker compose up -d\n```\n\nThis will start the application with the default CPU-based embedding provider.\n\n# Or activate the virtual environment and install\nuv venv\n.\\.venv\\Scripts\\activate\nuv pip install -e .\n```\n\n## Usage\n\n### Database Migration and Testing\n\n```bash\n# Migrate data from JSON to SQLite database\nuv run migrate.py --input starred_repos_summary.json --output github_stars.db\n\n# Test database functionality\nuv run test_db.py --db github_stars.db\n\n# test Ollama \nuv run python test_ollama.py --model \"qwen2.5-coder:latest\"\n```\n\n### With different AI providers\n\n```bash\n# Using OpenAI\nuv run main.py --username kdcllc --ai-provider openai --openai-key \"your-key\" --max-pages 1\n\n# Using Azure OpenAI\nuv run main.py --username kdcllc --ai-provider azure --azure-key \"your-key\" --azure-endpoint \"your-endpoint\" --azure-deployment \"your-deployment\" --max-pages 1\n\n# Using Ollama (local)\nuv run main.py --username kdcllc --ai-provider ollama --model \"qwen2.5-coder:latest\" --max-pages 1\n```\n\n\n#### OpenAI (default)\n\n```powershell\n# Using command line arguments\nuv run main.py \u003cgithub_username\u003e --github-token \u003cyour_token\u003e --openai-key \u003cyour_key\u003e\n\n# Using environment variables\n$env:GITHUB_TOKEN=\"your_github_token\"\n$env:OPENAI_API_KEY=\"your_openai_api_key\"\nuv run main.py \u003cgithub_username\u003e\n\n# Specify a different model\nuv run main.py \u003cgithub_username\u003e --ai-provider openai --model gpt-4\n```\n\n#### Azure OpenAI\n\n```powershell\n# Using command line arguments\nuv run main.py \u003cgithub_username\u003e --ai-provider azure --azure-key \u003cyour_key\u003e --azure-endpoint \u003cyour_endpoint\u003e --azure-deployment \u003cdeployment_name\u003e\n\n# Using environment variables\n$env:GITHUB_TOKEN=\"your_github_token\"\n$env:AZURE_OPENAI_API_KEY=\"your_azure_api_key\"\n$env:AZURE_OPENAI_ENDPOINT=\"your_azure_endpoint\"\n$env:AZURE_OPENAI_DEPLOYMENT=\"your_deployment_name\"\nuv run main.py \u003cgithub_username\u003e --ai-provider azure\n```\n\n#### Ollama (Local LLM)\n\n```powershell\n# Using local Ollama instance (default URL: http://localhost:11434)\nuv run main.py \u003cgithub_username\u003e --ai-provider ollama --model llama3\n\n# Using remote Ollama instance\nuv run main.py \u003cgithub_username\u003e --ai-provider ollama --ollama-url http://your-ollama-server:11434 --model mistral\n```\n\n### Searching and Querying\n\n```bash\n# Search repositories by semantic similarity\nuv run main.py --search \"docker containerization\" --db github_stars.db --username username\n```\n\n## Example Output\n\n```json\n{\n  \"repositories\": [\n    {\n      \"name\": \"repo-name\",\n      \"full_name\": \"owner/repo-name\",\n      \"url\": \"https://github.com/owner/repo-name\",\n      \"description\": \"Repository description\",\n      \"stars\": 1234,\n      \"language\": \"Python\",\n      \"summary\": \"This repository provides a framework for creating machine learning models with a focus on natural language processing.\",\n      \"technologies\": [\"Python\", \"PyTorch\", \"Transformers\", \"NLTK\"],\n      \"primary_goal\": \"To simplify the process of building and deploying NLP models.\"\n    },\n    ...\n  ]\n}\n```\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkdcllc%2Fagentic-ai-github-stars","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkdcllc%2Fagentic-ai-github-stars","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkdcllc%2Fagentic-ai-github-stars/lists"}