aryeo

v0.2.0 suspicious
4.0
Medium Risk

Typed Python client for the Aryeo API.

🤖 AI Analysis

Final verdict: SUSPICIOUS

The package shows some signs of potential misuse, particularly with network and metadata risks, but lacks clear evidence of malicious intent.

  • network risk due to HTTP client usage
  • metadata risk due to single package and lack of associated GitHub repo
Per-check LLM notes
  • Network: The use of HTTP client and Sentry reporter might be legitimate for error reporting or telemetry, but further investigation is needed to confirm its purpose.
  • Shell: No shell execution patterns were detected, indicating low risk for direct system command execution.
  • Obfuscation: No obfuscation patterns detected, indicating low risk.
  • Credentials: No credential harvesting patterns detected, indicating low risk.
  • Metadata: The maintainer has only one package and no associated GitHub repository, which could indicate a less established or potentially suspicious account.

📦 Package Quality Overall: Low (4.8/10)

✦ High Test Suite 9.0

Test suite present — 18 test file(s) found

  • Test runner config found: pyproject.toml
  • 18 test file(s) detected (e.g. test_addresses.py)
◈ Medium Documentation 5.0

Some documentation present

  • Detailed PyPI description (3731 chars)
○ Low Contributing Guide 2.0

No contributing guide or governance files found

  • No CONTRIBUTING, CODE_OF_CONDUCT, or governance files found
◈ Medium Type Annotations 7.0

Partial type annotation coverage

  • Classifier: Typing :: Typed
  • Type checker (mypy / pyright / pytype) referenced in project
  • 131 type-annotated function signatures detected in source
○ Low Multiple Contributors 1.0

Unable to verify contributor count: no GitHub repository found

  • No GitHub repository linked — contributor count unavailable

🔬 Heuristic Checks

⚠ Outbound Network Calls score 1.5

Found 1 network call pattern(s)

  • _http_client = http_client or httpx.Client() self._sentry_reporter: SentryReporter | None = (
✓ Code Obfuscation

No obfuscation patterns detected

✓ Shell / Subprocess Execution

No shell execution patterns detected

✓ Credential Harvesting

No credential harvesting patterns detected

✓ Typosquatting

No typosquatting candidates detected

✓ Registered Email Domain

No author email provided

✓ Suspicious Page Links

All external links appear legitimate

✓ Git Repository History

No GitHub repository linked

  • No GitHub repository link found
⚠ Maintainer History score 2.0

1 maintainer concern(s) found

  • Author "Aryeo API Client Maintainers" appears to have only 1 package on PyPI (new or inactive account)
✓ Known CVE Vulnerabilities

No known vulnerabilities found in OSV database.

💡 AI App Starter Prompt

Use this prompt to build a project with aryeo 
Develop a real estate listing explorer mini-application using the Aryeo API client package in Python. This application will allow users to explore various real estate listings, filter them based on specific criteria, and save their favorite listings for future reference. Here’s a step-by-step guide on how to create this application:

1. **Setup**: Begin by installing the `aryeo` package and setting up your environment. Ensure you have access to an API key from Aryeo.
2. **User Interface**: Create a simple command-line interface (CLI) for the application. The CLI should allow users to input commands such as listing retrieval, filtering, and saving favorites.
3. **Core Functionality**:
   - Implement a function to fetch real estate listings from Aryeo's API. Use the `aryeo` package to make API calls and retrieve data.
   - Develop a filtering mechanism where users can specify filters like location, price range, property type, etc., to narrow down their search results.
4. **Favorites System**: Integrate a feature that allows users to mark certain listings as favorites. These favorites should be stored locally (e.g., in a JSON file) and can be retrieved and displayed at any time.
5. **Enhancements**:
   - Add support for displaying images of the properties if available through the API.
   - Include an option for users to sort listings by different criteria such as price, date listed, etc.
6. **Testing**: Thoroughly test the application to ensure all functionalities work as expected. Test with various scenarios including edge cases like no internet connection or invalid user inputs.
7. **Documentation**: Write clear documentation explaining how to install the application, use its features, and troubleshoot common issues.
8. **Deployment**: Consider deploying the application as a standalone executable or a web-based version for broader accessibility.

Throughout the development process, leverage the `aryeo` package to handle communication with Aryeo's API efficiently. Make sure to follow best practices for error handling and data validation.

💬 Discussion Feed

Leave a comment

No discussion yet. Be the first to share your thoughts!