{"id":27821,"library":"ghost-protocol","title":"Ghost Protocol","description":"Ghost Protocol is an automated repository guardian that detects and blocks spam, junk, and low-quality contributions. Version 1.3.1 requires Python >=3.8. It auto-ignores irrelevant files and protects repos from unwanted activity, with a focus on developer sanity. Release cadence is irregular.","status":"active","version":"1.3.1","language":"python","source_language":"en","source_url":"https://github.com/Adrena1ine-ai/Ghost-Protocol","tags":["repository-guard","security","automation","spam-detection","python"],"install":[{"cmd":"pip install ghost-protocol","lang":"bash","label":"Install from PyPI"}],"dependencies":[],"imports":[{"note":"Importing the class directly without the module prefix may fail if the package uses submodules.","wrong":"import GhostProtocol","symbol":"GhostProtocol","correct":"from ghost_protocol import GhostProtocol"}],"quickstart":{"code":"from ghost_protocol import GhostProtocol\nimport os\n\n# Initialize with optional API key\napi_key = os.environ.get('GHOST_API_KEY', '')\ngp = GhostProtocol(api_key=api_key)\n# Scan a repository for junk\nreport = gp.scan_repo('https://github.com/Adrena1ine-ai/Ghost-Protocol')\nprint(report)","lang":"python","description":"Initialize Ghost Protocol, optionally provide an API key via environment variable, and scan a repository."},"warnings":[{"fix":"Use 'from ghost_protocol import GhostProtocol'.","message":"The package 'ghost-protocol' is installed as a dash, but imported as an underscore (ghost_protocol). Many users incorrectly try to import as 'ghost-protocol'.","severity":"gotcha","affected_versions":"all"},{"fix":"Update call to gp.scan_repo(repository='your/repo') or use the alias.","message":"Version 1.3.0 changed the scan_repo method signature from requiring a 'repo_url' parameter to requiring 'repository' (or 'repo_url' as alias, but 'repository' is preferred). Old code using 'repo_url' may still work but is deprecated.","severity":"breaking","affected_versions":">=1.3.0"}],"env_vars":null,"last_verified":"2026-05-09T00:00:00.000Z","next_check":"2026-08-07T00:00:00.000Z","problems":[{"fix":"Use 'pip install ghost-protocol' and then 'from ghost_protocol import GhostProtocol'.","cause":"The package is installed with a hyphen (ghost-protocol), but the import uses an underscore (ghost_protocol). This is correct; the package provides the module name with underscores.","error":"ModuleNotFoundError: No module named 'ghost_protocol'"},{"fix":"Ensure you have the correct version and use 'from ghost_protocol import GhostProtocol'.","cause":"Trying to import GhostProtocol directly from the module, but the module may be a namespace package or the class is in a submodule.","error":"AttributeError: module 'ghost_protocol' has no attribute 'GhostProtocol'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}