A lightweight, friendly tool for discovering and inspecting remote Ollama servers on your network. This README is intentionally non-technical — see GUIDE.md for full installation steps, usage examples, and advanced options.
🌈 ## Overview
Ollama Remote Server Scanner helps you quickly locate Ollama instances on a network and gather basic metadata such as version and available models. It’s designed for developers and operators who want a fast, non-intrusive way to inventory Ollama servers.
🤖 ## Key Features
- Discovery of Ollama servers on local and remote networks
- Metadata collection including version and model lists
- Human-friendly output suitable for quick triage and automation
- Exportable results for reporting and integration
⚙️ ## Quick Start
- Open GUIDE.md for exact installation and run instructions specific to this project.
- Follow the commands in GUIDE.md to run discovery and scanning.
- Discover on local network — run the discovery workflow described in GUIDE.md to list reachable Ollama servers.
- Inspect a single host — see the host-targeting examples in GUIDE.md for how to query a specific IP or hostname.
- Export results — the guide documents available output formats (JSON, table, plain text) and how to save results.
Configuration options such as network ranges, timeouts, ports, and output formats are documented in GUIDE.md. If your environment requires authentication, follow the authentication section there.
⚡ ## Security and Responsible Use
- The scanner performs non-destructive metadata queries.
- Only scan networks and hosts you own or have explicit permission to scan.
- Do not run scans across untrusted networks without authorization.
💪🏻 ## Contributing
- Report bugs or request features via issues.
- Fork the repo, make focused changes, and open a pull request with a clear description and tests or examples when applicable.
- See GUIDE.md for contribution guidelines if present.
⛑️ ## Troubleshooting
- If no hosts are found, check network connectivity and firewall rules.
- If you encounter permission or authentication errors, consult the authentication section in GUIDE.md.
- For unexpected behavior, open an issue with logs and reproduction steps.
💌 ## License and Contact
- License: See the
LICENSEfile in this repository. - Contact: Open an issue for questions, support, or feature requests.
Enjoy ❤️
Yog-Sotho