{"id":28249,"library":"spotted","title":"Spotted Python SDK","description":"The official Python library for the Spotted API, providing a typed interface for programmatic access. Current version 0.31.1, with frequent releases reflecting active development.","status":"active","version":"0.31.1","language":"python","source_language":"en","source_url":"https://github.com/cjavdev/spotted-py","tags":["api-client","spotted","sdk"],"install":[{"cmd":"pip install spotted","lang":"bash","label":"Install via pip"}],"dependencies":[{"reason":"Required for type hints; minimum version enforced in 0.29.2","package":"typing-extensions","optional":false},{"reason":"Used for model serialization; known bug with by_alias in 0.29.1","package":"pydantic","optional":true}],"imports":[{"note":"The client is exported directly from the root package.","wrong":"from spotted.client import Spotted","symbol":"Spotted","correct":"from spotted import Spotted"},{"note":"The top-level module is `spotted`, not a named export.","wrong":"from spotted import spotted","symbol":"spotted","correct":"import spotted"}],"quickstart":{"code":"from spotted import Spotted\n\nclient = Spotted(api_key=os.environ.get('SPOTTED_API_KEY', ''))\n\nmodels = client.models.list()\nprint(models)","lang":"python","description":"Initialize the client with an API key from environment variable and list available models."},"warnings":[{"fix":"Use `from spotted import Spotted` instead of `from spotted import SpottedAPI`.","message":"The client class was renamed from `SpottedAPI` to `Spotted` in an early version. Using the old name will raise an ImportError.","severity":"breaking","affected_versions":"<0.1.0?"},{"fix":"Upgrade to >=0.30.2 or ensure file data is passed as a single tuple/list.","message":"File uploads require multi-part form data; ensure file paths are sent as a single parameter, not spread across multiple values. Bug fixed in 0.30.2.","severity":"gotcha","affected_versions":"<0.30.2"},{"fix":"Set headers via environment variables (e.g., `MY_HEADER=value`) or use the `default_headers` parameter in the client.","message":"Setting custom headers via constructor kwargs is deprecated in favor of environment variables. Support added in 0.31.0.","severity":"deprecated","affected_versions":">=0.31.0"}],"env_vars":null,"last_verified":"2026-05-09T00:00:00.000Z","next_check":"2026-08-07T00:00:00.000Z","problems":[{"fix":"Use `from spotted import Spotted`.","cause":"The client class was renamed from SpottedAPI to Spotted.","error":"ImportError: cannot import name 'SpottedAPI' from 'spotted'"},{"fix":"Pass files as `files=[('file', open('photo.jpg', 'rb'))]` or upgrade to >=0.30.2.","cause":"Multiple file arguments were incorrectly passed as separate parameters instead of a single list.","error":"Error: file data must be sent as a single parameter"},{"fix":"Upgrade to >=0.29.2 or ensure compatible pydantic version.","cause":"Pydantic version mismatch; a bug in 0.29.1 passed `by_alias` without checking if set.","error":"TypeError: 'by_alias' is an invalid keyword argument"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}