{"id":47291892,"url":"https://github.com/adanos-software/adanos-cli","last_synced_at":"2026-04-20T09:05:42.573Z","repository":{"id":344615666,"uuid":"1182354005","full_name":"adanos-software/adanos-cli","owner":"adanos-software","description":"CLI for the Adanos Finance Sentiment API","archived":false,"fork":false,"pushed_at":"2026-03-27T06:49:36.000Z","size":245,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-03T02:23:50.977Z","etag":null,"topics":["cli","finance","sentiment","stock-market"],"latest_commit_sha":null,"homepage":"https://adanos.org/finance-sentiment-cli","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/adanos-software.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-15T12:06:00.000Z","updated_at":"2026-03-27T06:49:39.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/adanos-software/adanos-cli","commit_stats":null,"previous_names":["adanos-software/adanos-cli"],"tags_count":9,"template":false,"template_full_name":null,"purl":"pkg:github/adanos-software/adanos-cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adanos-software%2Fadanos-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adanos-software%2Fadanos-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adanos-software%2Fadanos-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adanos-software%2Fadanos-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/adanos-software","download_url":"https://codeload.github.com/adanos-software/adanos-cli/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adanos-software%2Fadanos-cli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32040364,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-20T00:18:06.643Z","status":"online","status_checked_at":"2026-04-20T02:00:06.527Z","response_time":94,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["cli","finance","sentiment","stock-market"],"created_at":"2026-03-16T09:09:22.045Z","updated_at":"2026-04-20T09:05:42.568Z","avatar_url":"https://github.com/adanos-software.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# adanos-cli\n\n[![PyPI version](https://img.shields.io/pypi/v/adanos-cli.svg)](https://pypi.org/project/adanos-cli/)\n\n`adanos-cli` is the command-line client for the [Adanos Market Sentiment API](https://api.adanos.org/docs).\n\nIt is built for three use cases:\n- traders who want fast stock and crypto sentiment reports\n- analysts who want repeatable CLI workflows\n- agents and automation that need stable JSON output\n\nThe CLI is versioned independently from the API backend. It targets the public API at `https://api.adanos.org/docs` and uses the published Python SDK under the hood.\n\n## Install\n\n### Recommended\n\n```bash\npipx install adanos-cli\n```\n\n### cURL\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/adanos-software/adanos-cli/main/install.sh | bash\n```\n\nThe shell installer downloads the latest standalone binary for:\n- macOS arm64\n- macOS x86_64\n- Linux x86_64\n\nBy default it installs to `~/.local/bin`. Override with `ADANOS_INSTALL_DIR=/your/path`.\n\n### Homebrew (macOS / Linux)\n\n```bash\nbrew install adanos-software/tap/adanos-cli\n```\n\n### PowerShell (Windows)\n\n```powershell\nirm https://raw.githubusercontent.com/adanos-software/adanos-cli/main/install.ps1 | iex\n```\n\n### Plain pip\n\n```bash\npython3 -m pip install adanos-cli\n```\n\n### From source\n\n```bash\ngit clone https://github.com/adanos-software/adanos-cli.git\ncd adanos-cli\npython3 -m pip install -e \".[dev]\"\n```\n\n## Quick Start\n\nIf you already have an API key:\n\n```bash\nadanos login --api-key sk_live_xxx\nadanos whoami\nadanos doctor\n```\n\nFirst market checks:\n\n```bash\nadanos consensus TSLA --days 7\nadanos explain TSLA --profile investor --days 7\nadanos scan --asset stocks --style daytrader --days 7 --top 10\n```\n\nCrypto:\n\n```bash\nadanos crypto BTC --days 7\nadanos crypto BTC/ETH --days 7\n```\n\n## Start Modes\n\n`adanos` shows a compact start screen with the CLI header and next actions.\n\n```bash\nadanos\n```\n\nExplicit interactive shell:\n\n```bash\nadanos shell\n```\n\nOne-shot command mode:\n\n```bash\nadanos stock NVDA --days 7\n```\n\n## Authentication\n\nPersist a key locally:\n\n```bash\nadanos login --api-key sk_live_xxx\n```\n\nRequest a recovery email for an existing account:\n\n```bash\nadanos onboard recover --email you@example.com\n```\n\nStart a new signup from the CLI:\n\n```bash\nadanos onboard register --name \"Jane Doe\" --email \"jane@example.com\" --purpose \"Trading research\"\n# then redeem the one-time token from the verification email\nadanos onboard redeem --token kt_xxx --save\n```\n\nUse profiles:\n\n```bash\nadanos auth login --api-key sk_live_prod --profile prod\nadanos auth login --api-key sk_live_staging --profile staging\nadanos auth switch prod\nadanos auth current --json\n```\n\nPriority order:\n- `--api-key`\n- `ADANOS_API_KEY`\n- stored credentials in the active profile\n\n## Common Workflows\n\nStock report:\n\n```bash\nadanos stock TSLA --days 7\n```\n\nCross-platform consensus:\n\n```bash\nadanos consensus TSLA --days 7\n```\n\nNarrative explanation:\n\n```bash\nadanos explain TSLA --profile investor --days 7\n```\n\nWatchlists:\n\n```bash\nadanos watchlist add core --asset stocks --symbols TSLA,NVDA,AAPL\nadanos watchlist report core --asset stocks --days 7\nadanos watch core --kind watchlist --asset stocks --refresh 60 --iterations 1\n```\n\nRaw endpoint access:\n\n```bash\nadanos endpoint list\nadanos endpoint call reddit-stocks.trending --days 1 --limit 10\nadanos endpoint call reddit-stocks.market-sentiment --days 7\nadanos endpoint call x-stocks.stock.explain --ticker TSLA\n```\n\n## AI / Automation\n\nThe CLI supports machine-readable output via `--output json` or `--quiet`.\n\n```bash\nadanos --quiet capabilities\nadanos --quiet whoami\nadanos --quiet doctor\nadanos --quiet ask \"How does TSLA look?\"\nadanos --quiet endpoint call news-stocks.trending --days 1 --limit 3\n```\n\nJSON conventions:\n- object payloads include a stable `kind`\n- command wrappers include `command`, and `subcommand` when relevant\n- endpoint-backed payloads include `platform`, `route`, `endpoint`, `path`, and `data`\n\n## Diagnostics\n\nIdentity and runtime context:\n\n```bash\nadanos whoami\n```\n\nProblem-focused self-check:\n\n```bash\nadanos doctor\nadanos doctor --verbose\n```\n\n## Releases\n\nTagged releases build standalone archives for:\n- macOS arm64\n- macOS x86_64\n- Linux x86_64\n\nThe repo also generates a Homebrew formula artifact for each tagged binary release and can publish it to `adanos-software/homebrew-tap` when `HOMEBREW_TAP_TOKEN` is configured.\n\nPyPI publishing also happens from this repo, not from the API monorepo.\n\n## Development\n\nInstall the repo in editable mode:\n\n```bash\npython3 -m pip install -e \".[dev]\"\n```\n\nRun tests:\n\n```bash\npython3 -m pytest tests -q\n```\n\nBuild wheel and sdist:\n\n```bash\npython3 -m build\n```\n\nBuild a standalone binary archive locally:\n\n```bash\npython3 scripts/build_cli_binary.py --output-dir dist-binaries\n```\n\nGenerate a Homebrew formula:\n\n```bash\nVERSION=$(python3 - \u003c\u003c'PY'\nimport re\nfrom pathlib import Path\ntext = Path(\"src/adanos_cli/__init__.py\").read_text(encoding=\"utf-8\")\nprint(re.search(r'__version__\\s*=\\s*\"([^\"]+)\"', text).group(1))\nPY\n)\n\npython3 scripts/generate_homebrew_formula.py \\\n  --version \"$VERSION\" \\\n  --darwin-arm64-url \"https://example.com/adanos-cli-${VERSION}-darwin-arm64.tar.gz\" \\\n  --darwin-arm64-sha256 \u003csha256\u003e \\\n  --darwin-x86_64-url \"https://example.com/adanos-cli-${VERSION}-darwin-x86_64.tar.gz\" \\\n  --darwin-x86_64-sha256 \u003csha256\u003e \\\n  --linux-x86_64-url \"https://example.com/adanos-cli-${VERSION}-linux-x86_64.tar.gz\" \\\n  --linux-x86_64-sha256 \u003csha256\u003e \\\n  --output dist/homebrew/adanos-cli.rb\n```\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadanos-software%2Fadanos-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fadanos-software%2Fadanos-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadanos-software%2Fadanos-cli/lists"}