aqc-cli 1.0.0__tar.gz

aqc_cli-1.0.0/LICENSE

@@ -0,0 +1,31 @@
+BSD 3-Clause License
+
+Copyright (c) [2025], [inoribea]
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions
+are met:
+
+1. Redistributions of source code must retain the above copyright
+   notice, this list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright
+   notice, this list of conditions and the following disclaimer in the
+   documentation and/or other materials provided with the distribution.
+
+3. Neither the name of inoribea nor the names of its
+    contributors may be used to endorse or promote products derived from
+    this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGE.

aqc_cli-1.0.0/PKG-INFO

@@ -0,0 +1,346 @@
+Metadata-Version: 2.4
+Name: aqc-cli
+Version: 1.0.0
+Summary: CLI for astroquery modules with autocompletion and multi-language support.
+License: BSD-3-Clause
+License-File: LICENSE
+Author: inoribea
+Author-email: inoribea@outlook.com
+Requires-Python: >=3.11
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Dist: astropy (>=7.1.0,<8.0.0)
+Requires-Dist: astroquery (>=0.4.10,<0.5.0)
+Requires-Dist: babel (>=2.15.0,<3.0.0)
+Requires-Dist: pyvo (>=1.4.1,<2.0.0)
+Requires-Dist: requests (>=2.10.0,<3.0.0)
+Requires-Dist: rich (>=13.5.2,<14.0.0)
+Requires-Dist: typer (>=0.15.4,<0.16.0)
+Project-URL: Documentation, https://github.com/inoribea/astroquery-cli#readme
+Project-URL: Homepage, https://github.com/inoribea/astroquery-cli
+Project-URL: Issues, https://github.com/inoribea/astroquery-cli/issues
+Project-URL: Repository, https://github.com/inoribea/astroquery-cli
+Description-Content-Type: text/markdown
+
+# Astro CLI 🚀
+
+> Your gateway to cosmos — Query astronomical data from command line
+
+[![License](https://img.shields.io/badge/License-BSD%203Clause-blue.svg)](LICENSE)
+[![Python](https://img.shields.io/badge/python-3.11%2B-blue.svg)](https://www.python.org/downloads/)
+[![Astropy](https://img.shields.io/badge/astropy-6.0%2B-orange.svg)](https://www.astropy.org/)
+
+---
+
+## ✨ What is Astro CLI?
+
+**Astro CLI** (working title: suggestions welcome!) is a modern command-line tool that provides quick access to multiple astronomical data services through the [Astroquery](https://astroquery.readthedocs.io/) library. It's designed for astronomers, researchers, and anyone who needs to query astronomical databases efficiently from the terminal.
+
+*17 data sources. One command. Beautiful output. Multi-language support. Extensible for future services.*
+
+---
+
+## 🧩 Supported Data Sources
+
+Query data from 17 different astronomical databases and services:
+
+| Service | Description | Command | Alias |
+|---------|------------|----------|--------|
+| [SIMBAD](https://simbad.cds.unistra.fr/) | Basic astronomical data & object identification | `astrocli simbad` | `astrocli sim` |
+| [VizieR](https://vizier.cds.unistra.fr/) | Catalog database search | `astrocli vizier` | `astrocli viz` |
+| [ALMA](https://almascience.org/) | ALMA radio telescope observations | `astrocli alma` | - |
+| [ESASky](https://www.esa.int/Enabling_Support/Operations/ESASky/) | Sky region visualization | `astrocli esasky` | - |
+| [Gaia](https://www.cosmos.esa.int/gaia/) | ESA Gaia mission data | `astrocli gaia` | - |
+| [IRSA](https://irsa.ipac.caltech.edu/) | Infrared Science Archive | `astrocli irsa` | - |
+| [HEASARC](https://heasarc.gsfc.nasa.gov/) | X-ray and Gamma-ray data | `astrocli heasarc` | `astrocli hea` |
+| [JPL Horizons](https://ssd.jpl.nasa.gov/) | Solar System ephemerides | `astrocli jpl` | - |
+| [MAST](https://mast.stsci.edu/) | Space Telescope Archive (HST, JWST, etc.) | `astrocli mast` | - |
+| [ADS](https://ui.adsabs.harvard.edu/) | Astrophysics literature search | `astrocli ads` | - |
+| [NED](https://ned.ipac.caltech.edu/) | Extragalactic Database | `astrocli ned` | - |
+| [NIST](https://physics.nist.gov/ASD/) | Atomic spectra database | `astrocli nist` | - |
+| [NASA Exoplanet](https://exoplanetarchive.ipac.caltech.edu/) | Exoplanet catalog | `astrocli exoplanet` | `astrocli exo` |
+| [SDSS](https://www.sdss.org/) | Sloan Digital Sky Survey | `astrocli sdss` | - |
+| [ESO](https://www.eso.org/) | European Southern Observatory | `astrocli eso` | - |
+| [Splatalogue](https://www.splatalogue.org/) | Molecular line database | `astrocli splatalogue` | `astrocli spl` |
+| [**AAVSO VSX**](https://www.aavso.org/vsx/) | Variable Star Index | `astrocli aavso` | - |
+| [**Fermi-LAT**](https://fermi.gsfc.nasa.gov/) | Gamma-ray telescope data | `astrocli fermi` | - |
+
+---
+
+## 🌟 Key Features
+
+- **📦 Multi-Source Access**: Query 17+ astronomical databases from a single interface
+- **🌏 Internationalized UI**: Built-in support for English, Chinese (Simplified), and Japanese
+- **📊 Rich Output**: Beautifully formatted tables with support for exporting to CSV, ECSV, FITS, and more
+- **⚡ Smart Defaults**: Sensible defaults with extensive customization options
+- **🔍 Service Health**: Built-in connectivity testing (`--ping`) and field validation (`--field`)
+- **🧑‍💻 Shell Completion**: Auto-completion support for Bash, Zsh, and Fish
+- **🌌 Extensible**: Easy to add new astronomical data services
+
+---
+
+## 📦 Installation
+
+### Quick Start (via npx/pnpm)
+
+Requires: Node.js ≥18 and Python 3.11+
+
+```bash
+# Using pnpm (recommended)
+pnpm astrocli --help
+
+# Using npx
+npx astrocli --help
+
+# Example: Query SIMBAD for M31
+pnpm astrocli simbad object "M31"
+```
+
+### Environment Variables
+
+- `AC_PYTHON` - Specify Python interpreter path
+- `AC_VENV_DIR` - Custom virtual environment cache directory (default: `~/.cache/astrocli`)
+- `AC_FORCE_INSTALL=1` - Force reinstall/upgrade Python dependencies
+- `AC_DEBUG` - Enable debug mode
+- `AC_LANG` - Set default language (en/zh/ja)
+
+### Install from Source
+
+```bash
+git clone https://github.com/yourusername/astrocli.git
+cd astrocli
+pip install -e .
+```
+
+---
+
+## 📚 Usage
+
+### View All Available Commands
+
+```bash
+# Show all available modules and commands
+astrocli --help
+
+# Show help for a specific module
+astrocli <module> --help
+```
+
+### Query Examples
+
+#### 1. Query SIMBAD for an object
+
+```bash
+astrocli simbad object "M31"
+astrocli simbad object "Crab Nebula" --show-all-cols
+```
+
+#### 2. Search VizieR catalogs
+
+```bash
+# Find catalogs by keywords
+astrocli vizier find-catalogs --keyword photometry --keyword galaxy
+
+# Query a specific catalog
+astrocli vizier object "M31" --radius 0.1 --catalog "I/261/gaiadr3"
+```
+
+#### 3. Query AAVSO Variable Star Index (NEW!)
+
+```bash
+# Query a variable star by name
+astrocli aavso object "SS Cyg"
+
+# Search variable stars in a sky region
+astrocli aavso region 196.421 18.018 --radius 0.5
+
+# Get results in JSON format
+astrocli aavso object "T CrB" --format json
+```
+
+#### 4. Query Fermi-LAT Data (NEW!)
+
+```bash
+# Query Fermi data for a target
+astrocli fermi object "Crab Nebula" --energy "1000,100000" --dates "2020-01-01 00:00:00, 2020-01-02 00:00:00"
+
+# Clear Fermi cache
+astrocli fermi clear-cache
+```
+
+#### 5. Search ADS literature
+
+```bash
+astrocli ads search --title "exoplanet detection"
+astrocli ads bibcode "2023A&A...555..959W"
+```
+
+---
+
+## 🌐 Multi-Language Support
+
+Change output language on-the-fly:
+
+```bash
+astrocli --lang zh simbad object "M31"    # Chinese
+astrocli --lang ja simbad object "M31"    # Japanese
+astrocli --lang en simbad object "M31"    # English
+```
+
+---
+
+## 🔧 Global Options
+
+| Option | Description |
+|---------|-------------|
+| `-l, --lang` | Set output language (en/zh/ja) |
+| `-p, --ping` | Test connectivity to all services (top-level only) |
+| `-f, --field` | Check available fields for a module (top-level only) |
+| `-d, --debug` | Enable debug mode with verbose output |
+| `-v, --verbose` | Enable verbose output |
+
+---
+
+## 🧑‍💻 Shell Autocompletion
+
+Install completion for your shell:
+
+```bash
+astrocli --install-completion bash   # Bash
+astrocli --install-completion zsh    # Zsh
+astrocli --install-completion fish   # Fish
+```
+
+Add this to your shell config (e.g., `~/.zshrc`):
+
+```bash
+# For zsh
+eval "$(astrocli --install-completion zsh)"
+
+# For bash
+eval "$(astrocli --install-completion bash)"
+```
+
+---
+
+## 📊 Output & Export
+
+Save query results to file:
+
+```bash
+astrocli simbad object "M31" --output-file results.csv
+
+# Specify format explicitly
+astrocli simbad object "M31" --output-file data.ecsv --output-format ecsv
+```
+
+Supported formats: `csv`, `ecsv`, `fits`, `votable`, `html`, `latex`, `ascii`
+
+---
+
+## 🔍 Testing Service Connectivity
+
+Check if all data services are accessible:
+
+```bash
+astrocli --ping
+```
+
+---
+
+## 🛠️ Development
+
+### Project Structure
+
+```
+astrocli/
+├── astrocli/
+│   ├── modules/           # Service-specific modules
+│   │   ├── simbad_cli.py
+│   │   ├── vizier_cli.py
+│   │   ├── aavso_cli.py      # NEW: AAVSO VSX
+│   │   ├── fermi_cli.py       # NEW: Fermi-LAT
+│   │   └── ...
+│   ├── utils.py            # Common utilities
+│   ├── common_options.py   # Shared CLI options
+│   ├── i18n.py            # Internationalization
+│   └── main.py            # CLI entry point
+├── locales/                # Translation files
+│   ├── zh/LC_MESSAGES/
+│   ├── ja/LC_MESSAGES/
+│   └── en/LC_MESSAGES/
+├── package.json           # pnpm/npx configuration
+├── pyproject.toml         # Python package config
+└── README.md
+```
+
+### Adding a New Module
+
+1. Create `modules/<service>_cli.py` following existing patterns
+2. Import in `main.py`'s `setup_subcommands()`
+3. Add to README module list
+4. Add translations to `locales/` directories
+
+---
+
+## 📄 License
+
+BSD 3-Clause License
+
+This project uses [Astroquery](https://github.com/astropy/astroquery), which is licensed under the BSD 3-Clause License.
+
+---
+
+## 🙏 Acknowledgments
+
+- [Astroquery](https://astroquery.readthedocs.io/) - Core library for astronomical data access
+- [Typer](https://typer.tiangolo.com/) - Modern CLI framework
+- [Rich](https://github.com/Textualize/rich) - Beautiful terminal output
+- [AAVSO](https://www.aavso.org/) - American Association of Variable Star Observers
+- [Fermi Team](https://fermi.gsfc.nasa.gov/) - Fermi Gamma-ray Space Telescope
+
+---
+
+## 🔄 Migration from astroquery-cli
+
+If you were previously using `astroquery-cli`, simply change your command:
+
+```bash
+# Old command
+aqc simbad object "M31"
+
+# New command
+astrocli simbad object "M31"
+```
+
+All aliases remain the same: `sim` for `simbad`, `viz` for `vizier`, `spl` for `splatalogue`, etc.
+
+---
+
+## 📝 FAQ
+
+<details>
+<summary><b>Common Questions</b></summary>
+
+### Can I use this without Node.js?
+
+Yes! Install from source: `pip install -e .` or use Python directly after installing dependencies.
+
+### How do I add a new data service?
+
+See the [Development](#-development) section above. Most services in Astroquery can be wrapped with similar patterns.
+
+### Why do some modules say "not fully implemented"?
+
+Some advanced features or edge cases may not have full CLI coverage yet. Core query functionality works, but special parameters might need direct access to the underlying astroquery library.
+
+### What's the difference between this and astroquery?
+
+**Astro CLI** is a command-line interface for Astroquery. Think of it as a user-friendly wrapper that makes common tasks easier. It doesn't replace Astroquery — it enhances it!
+
+</details>
+

aqc_cli-1.0.0/README.md

@@ -0,0 +1,317 @@
+# Astro CLI 🚀
+
+> Your gateway to cosmos — Query astronomical data from command line
+
+[![License](https://img.shields.io/badge/License-BSD%203Clause-blue.svg)](LICENSE)
+[![Python](https://img.shields.io/badge/python-3.11%2B-blue.svg)](https://www.python.org/downloads/)
+[![Astropy](https://img.shields.io/badge/astropy-6.0%2B-orange.svg)](https://www.astropy.org/)
+
+---
+
+## ✨ What is Astro CLI?
+
+**Astro CLI** (working title: suggestions welcome!) is a modern command-line tool that provides quick access to multiple astronomical data services through the [Astroquery](https://astroquery.readthedocs.io/) library. It's designed for astronomers, researchers, and anyone who needs to query astronomical databases efficiently from the terminal.
+
+*17 data sources. One command. Beautiful output. Multi-language support. Extensible for future services.*
+
+---
+
+## 🧩 Supported Data Sources
+
+Query data from 17 different astronomical databases and services:
+
+| Service | Description | Command | Alias |
+|---------|------------|----------|--------|
+| [SIMBAD](https://simbad.cds.unistra.fr/) | Basic astronomical data & object identification | `astrocli simbad` | `astrocli sim` |
+| [VizieR](https://vizier.cds.unistra.fr/) | Catalog database search | `astrocli vizier` | `astrocli viz` |
+| [ALMA](https://almascience.org/) | ALMA radio telescope observations | `astrocli alma` | - |
+| [ESASky](https://www.esa.int/Enabling_Support/Operations/ESASky/) | Sky region visualization | `astrocli esasky` | - |
+| [Gaia](https://www.cosmos.esa.int/gaia/) | ESA Gaia mission data | `astrocli gaia` | - |
+| [IRSA](https://irsa.ipac.caltech.edu/) | Infrared Science Archive | `astrocli irsa` | - |
+| [HEASARC](https://heasarc.gsfc.nasa.gov/) | X-ray and Gamma-ray data | `astrocli heasarc` | `astrocli hea` |
+| [JPL Horizons](https://ssd.jpl.nasa.gov/) | Solar System ephemerides | `astrocli jpl` | - |
+| [MAST](https://mast.stsci.edu/) | Space Telescope Archive (HST, JWST, etc.) | `astrocli mast` | - |
+| [ADS](https://ui.adsabs.harvard.edu/) | Astrophysics literature search | `astrocli ads` | - |
+| [NED](https://ned.ipac.caltech.edu/) | Extragalactic Database | `astrocli ned` | - |
+| [NIST](https://physics.nist.gov/ASD/) | Atomic spectra database | `astrocli nist` | - |
+| [NASA Exoplanet](https://exoplanetarchive.ipac.caltech.edu/) | Exoplanet catalog | `astrocli exoplanet` | `astrocli exo` |
+| [SDSS](https://www.sdss.org/) | Sloan Digital Sky Survey | `astrocli sdss` | - |
+| [ESO](https://www.eso.org/) | European Southern Observatory | `astrocli eso` | - |
+| [Splatalogue](https://www.splatalogue.org/) | Molecular line database | `astrocli splatalogue` | `astrocli spl` |
+| [**AAVSO VSX**](https://www.aavso.org/vsx/) | Variable Star Index | `astrocli aavso` | - |
+| [**Fermi-LAT**](https://fermi.gsfc.nasa.gov/) | Gamma-ray telescope data | `astrocli fermi` | - |
+
+---
+
+## 🌟 Key Features
+
+- **📦 Multi-Source Access**: Query 17+ astronomical databases from a single interface
+- **🌏 Internationalized UI**: Built-in support for English, Chinese (Simplified), and Japanese
+- **📊 Rich Output**: Beautifully formatted tables with support for exporting to CSV, ECSV, FITS, and more
+- **⚡ Smart Defaults**: Sensible defaults with extensive customization options
+- **🔍 Service Health**: Built-in connectivity testing (`--ping`) and field validation (`--field`)
+- **🧑‍💻 Shell Completion**: Auto-completion support for Bash, Zsh, and Fish
+- **🌌 Extensible**: Easy to add new astronomical data services
+
+---
+
+## 📦 Installation
+
+### Quick Start (via npx/pnpm)
+
+Requires: Node.js ≥18 and Python 3.11+
+
+```bash
+# Using pnpm (recommended)
+pnpm astrocli --help
+
+# Using npx
+npx astrocli --help
+
+# Example: Query SIMBAD for M31
+pnpm astrocli simbad object "M31"
+```
+
+### Environment Variables
+
+- `AC_PYTHON` - Specify Python interpreter path
+- `AC_VENV_DIR` - Custom virtual environment cache directory (default: `~/.cache/astrocli`)
+- `AC_FORCE_INSTALL=1` - Force reinstall/upgrade Python dependencies
+- `AC_DEBUG` - Enable debug mode
+- `AC_LANG` - Set default language (en/zh/ja)
+
+### Install from Source
+
+```bash
+git clone https://github.com/yourusername/astrocli.git
+cd astrocli
+pip install -e .
+```
+
+---
+
+## 📚 Usage
+
+### View All Available Commands
+
+```bash
+# Show all available modules and commands
+astrocli --help
+
+# Show help for a specific module
+astrocli <module> --help
+```
+
+### Query Examples
+
+#### 1. Query SIMBAD for an object
+
+```bash
+astrocli simbad object "M31"
+astrocli simbad object "Crab Nebula" --show-all-cols
+```
+
+#### 2. Search VizieR catalogs
+
+```bash
+# Find catalogs by keywords
+astrocli vizier find-catalogs --keyword photometry --keyword galaxy
+
+# Query a specific catalog
+astrocli vizier object "M31" --radius 0.1 --catalog "I/261/gaiadr3"
+```
+
+#### 3. Query AAVSO Variable Star Index (NEW!)
+
+```bash
+# Query a variable star by name
+astrocli aavso object "SS Cyg"
+
+# Search variable stars in a sky region
+astrocli aavso region 196.421 18.018 --radius 0.5
+
+# Get results in JSON format
+astrocli aavso object "T CrB" --format json
+```
+
+#### 4. Query Fermi-LAT Data (NEW!)
+
+```bash
+# Query Fermi data for a target
+astrocli fermi object "Crab Nebula" --energy "1000,100000" --dates "2020-01-01 00:00:00, 2020-01-02 00:00:00"
+
+# Clear Fermi cache
+astrocli fermi clear-cache
+```
+
+#### 5. Search ADS literature
+
+```bash
+astrocli ads search --title "exoplanet detection"
+astrocli ads bibcode "2023A&A...555..959W"
+```
+
+---
+
+## 🌐 Multi-Language Support
+
+Change output language on-the-fly:
+
+```bash
+astrocli --lang zh simbad object "M31"    # Chinese
+astrocli --lang ja simbad object "M31"    # Japanese
+astrocli --lang en simbad object "M31"    # English
+```
+
+---
+
+## 🔧 Global Options
+
+| Option | Description |
+|---------|-------------|
+| `-l, --lang` | Set output language (en/zh/ja) |
+| `-p, --ping` | Test connectivity to all services (top-level only) |
+| `-f, --field` | Check available fields for a module (top-level only) |
+| `-d, --debug` | Enable debug mode with verbose output |
+| `-v, --verbose` | Enable verbose output |
+
+---
+
+## 🧑‍💻 Shell Autocompletion
+
+Install completion for your shell:
+
+```bash
+astrocli --install-completion bash   # Bash
+astrocli --install-completion zsh    # Zsh
+astrocli --install-completion fish   # Fish
+```
+
+Add this to your shell config (e.g., `~/.zshrc`):
+
+```bash
+# For zsh
+eval "$(astrocli --install-completion zsh)"
+
+# For bash
+eval "$(astrocli --install-completion bash)"
+```
+
+---
+
+## 📊 Output & Export
+
+Save query results to file:
+
+```bash
+astrocli simbad object "M31" --output-file results.csv
+
+# Specify format explicitly
+astrocli simbad object "M31" --output-file data.ecsv --output-format ecsv
+```
+
+Supported formats: `csv`, `ecsv`, `fits`, `votable`, `html`, `latex`, `ascii`
+
+---
+
+## 🔍 Testing Service Connectivity
+
+Check if all data services are accessible:
+
+```bash
+astrocli --ping
+```
+
+---
+
+## 🛠️ Development
+
+### Project Structure
+
+```
+astrocli/
+├── astrocli/
+│   ├── modules/           # Service-specific modules
+│   │   ├── simbad_cli.py
+│   │   ├── vizier_cli.py
+│   │   ├── aavso_cli.py      # NEW: AAVSO VSX
+│   │   ├── fermi_cli.py       # NEW: Fermi-LAT
+│   │   └── ...
+│   ├── utils.py            # Common utilities
+│   ├── common_options.py   # Shared CLI options
+│   ├── i18n.py            # Internationalization
+│   └── main.py            # CLI entry point
+├── locales/                # Translation files
+│   ├── zh/LC_MESSAGES/
+│   ├── ja/LC_MESSAGES/
+│   └── en/LC_MESSAGES/
+├── package.json           # pnpm/npx configuration
+├── pyproject.toml         # Python package config
+└── README.md
+```
+
+### Adding a New Module
+
+1. Create `modules/<service>_cli.py` following existing patterns
+2. Import in `main.py`'s `setup_subcommands()`
+3. Add to README module list
+4. Add translations to `locales/` directories
+
+---
+
+## 📄 License
+
+BSD 3-Clause License
+
+This project uses [Astroquery](https://github.com/astropy/astroquery), which is licensed under the BSD 3-Clause License.
+
+---
+
+## 🙏 Acknowledgments
+
+- [Astroquery](https://astroquery.readthedocs.io/) - Core library for astronomical data access
+- [Typer](https://typer.tiangolo.com/) - Modern CLI framework
+- [Rich](https://github.com/Textualize/rich) - Beautiful terminal output
+- [AAVSO](https://www.aavso.org/) - American Association of Variable Star Observers
+- [Fermi Team](https://fermi.gsfc.nasa.gov/) - Fermi Gamma-ray Space Telescope
+
+---
+
+## 🔄 Migration from astroquery-cli
+
+If you were previously using `astroquery-cli`, simply change your command:
+
+```bash
+# Old command
+aqc simbad object "M31"
+
+# New command
+astrocli simbad object "M31"
+```
+
+All aliases remain the same: `sim` for `simbad`, `viz` for `vizier`, `spl` for `splatalogue`, etc.
+
+---
+
+## 📝 FAQ
+
+<details>
+<summary><b>Common Questions</b></summary>
+
+### Can I use this without Node.js?
+
+Yes! Install from source: `pip install -e .` or use Python directly after installing dependencies.
+
+### How do I add a new data service?
+
+See the [Development](#-development) section above. Most services in Astroquery can be wrapped with similar patterns.
+
+### Why do some modules say "not fully implemented"?
+
+Some advanced features or edge cases may not have full CLI coverage yet. Core query functionality works, but special parameters might need direct access to the underlying astroquery library.
+
+### What's the difference between this and astroquery?
+
+**Astro CLI** is a command-line interface for Astroquery. Think of it as a user-friendly wrapper that makes common tasks easier. It doesn't replace Astroquery — it enhances it!
+
+</details>