{"id":17563975,"url":"https://github.com/needmorecowbell/giggity","last_synced_at":"2025-05-07T10:36:22.936Z","repository":{"id":57434295,"uuid":"165938564","full_name":"needmorecowbell/giggity","owner":"needmorecowbell","description":"Wraps github api for openly available information about an organization, user, or repo","archived":false,"fork":false,"pushed_at":"2023-05-22T21:36:53.000Z","size":151,"stargazers_count":130,"open_issues_count":10,"forks_count":19,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-04-29T01:46:03.791Z","etag":null,"topics":["information-security","osint","python3"],"latest_commit_sha":null,"homepage":"","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/needmorecowbell.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}},"created_at":"2019-01-15T23:18:37.000Z","updated_at":"2025-03-30T15:13:37.000Z","dependencies_parsed_at":"2024-01-07T11:04:50.003Z","dependency_job_id":null,"html_url":"https://github.com/needmorecowbell/giggity","commit_stats":{"total_commits":43,"total_committers":5,"mean_commits":8.6,"dds":0.2093023255813954,"last_synced_commit":"83fd780671ad9c0e99c26447311474c6b4e696ef"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/needmorecowbell%2Fgiggity","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/needmorecowbell%2Fgiggity/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/needmorecowbell%2Fgiggity/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/needmorecowbell%2Fgiggity/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/needmorecowbell","download_url":"https://codeload.github.com/needmorecowbell/giggity/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252860587,"owners_count":21815537,"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":["information-security","osint","python3"],"created_at":"2024-10-21T13:10:39.607Z","updated_at":"2025-05-07T10:36:22.894Z","avatar_url":"https://github.com/needmorecowbell.png","language":"Python","funding_links":[],"categories":["Exfiltration"],"sub_categories":["Purple Team"],"readme":"#  Giggity - grab hierarchical data about a github organization, user, or repo\n\n\u003cp align=\"center\"\u003e\n    \u003cimg src=\"https://user-images.githubusercontent.com/9204902/51312125-3aa4d700-1a53-11e9-89e8-a02063d93595.gif\"\u003e\u003c/img\u003e\n\u003c/p\u003e\n\nGet information about an organization, user, or repo on github. Stores all data in a json file, organized in a tree of dictionaries for easy database transfer or data analysis. All done through the github api, with or without authentication (authentication highly recommended).\n\n**Warning:** Github API still supports v3 (what this script uses), however they are making the shift to graphql in v4. [Here](https://developer.github.com/v4/guides/migrating-from-rest/) is a post on migrating from v3. I don't know if I will update this script before it becomes deprecated, but beware.\n\n## Setup\n\n`pip3 install giggity`\n\n\nor clone the repository and run: \n\n`pip3 install -r requirements.txt`\n\n\n## Operation\n\n```\ngiggity.py [-h] [-v] [-a] [-u] [-o] [-O OUTPUT] path\n\npositional arguments:\n  path                  name of organization or user (or url of repository)\n\noptional arguments:\n  -h, --help            show this help message and exit\n  -v, --verbose         increase output verbosity\n  -a, --authenticate    allows github authentication to avoid ratelimiting\n  -u, --user            denotes that given input is a user\n  -o, --org             denotes that given input is an organization\n  -O OUTPUT, --outfile OUTPUT\n                        location to put generated json file\n\n```\n\n**Example of Scraping a User**\n\n    python3 giggity.py -a -O needmorecowbell.json -v -u needmorecowbell\n\n- This will ask for authentication credentials, put the program into verbose mode, scrape github for the user needmorecowbell, then put the results into needmorecowbell.json\n\n**Example of Scraping an Organization**\n\n    python3 giggity.py -a -o github -O github.json\n\n- This will ask for authentication, scrape the github organization on github, then put out the results in github.json\n\n**Giggity as a Module** \n\n- giggity can also be used as a module -- all data is stored within orgTree as a nested dict.\n\n```python\nfrom giggity import giggity\n\ng = giggity(\"username\",\"password\")\ndata = g.getUsers(\"organization-name\", followers=True)\n\nprint(\"List of users in organization: \")\nfor user, info in data.items():\n    print(user)\n\ndata = g.getEmails(\"username\", verbose=True) # Get any emails found\n```\n\n**Other examples of how to use giggity are available in the util folder.**\n\n**Example Output**\n\n\nWhen `python3 giggity.py -a -u geohot -O output.json` is used..\n\noutput.json contains: \n\n```json\n{\n    \"emails\": [\n        \"george@comma.ai\",\n        \"other emails taken out of example\"\n    \n    ],\n    \"names\": [\n        \"Charles Ellis\",\n        \"George Hotz\"\n    ],\n    \"repos\": {\n        \"ORB_SLAM2\": {\n            \"created_at\": \"2017-04-08T00:21:13Z\",\n            \"description\": \"ORBSLAM2 running on Mac OS X cause I was on a plane and bored and maybe useful for someone?\",\n            \"fork\": true,\n            \"name\": \"ORB_SLAM2\",\n            \"updated_at\": \"2018-10-22T23:51:28Z\",\n            \"url\": \"https://github.com/geohot/ORB_SLAM2\"\n        },\n        { Many more repositories cut out for the example },\n        \"xnu-deps-linux\": {\n            \"created_at\": \"2013-10-02T00:36:29Z\",\n            \"description\": \"Mig/cctools for Linux combo makefile thingy\",\n            \"fork\": true,\n            \"name\": \"xnu-deps-linux\",\n            \"updated_at\": \"2016-05-01T16:04:45Z\",\n            \"url\": \"https://github.com/geohot/xnu-deps-linux\"\n        }\n    }\n}\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fneedmorecowbell%2Fgiggity","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fneedmorecowbell%2Fgiggity","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fneedmorecowbell%2Fgiggity/lists"}