v2ray-finder 0.6.0

Search and collect V2Ray servers from GitHub repositories

v2ray-finder

فارسی | English | Deutsch | 📋 CHANGELOG

---

A high-performance tool to fetch, aggregate, validate and health-check public V2Ray server configs from GitHub and curated subscription sources.

Built with love for eternal freedom ❤️

---

🚀 What's New in v0.6.0

🏗️ Pipeline class — single entry point for the full discovery → fetch → dedup → health → score chain
⚡ Async concurrent fetch — asyncio + httpx (10× faster for 30+ sources)
🔒 StopController — thread-safe cancellation for GUI/CLI workers
📦 PipelineResult — unified output dataclass
🧪 40 new tests — test_pipeline.py

from v2ray_finder import Pipeline, StopController

pipeline = Pipeline(check_health=True)
result = pipeline.run()
for score in result.scores[:5]:
    print(score.grade, score.config[:80])

Full docs: README.en.md | فارسی: README.fa.md | Changelog: CHANGELOG.md

---

📦 Quick Install

pip install v2ray-finder                # core
pip install "v2ray-finder[async]"       # + httpx for concurrent fetch
pip install "v2ray-finder[all]"         # everything

---

🧪 Test Coverage

~85% across Python 3.8–3.12, Linux, macOS & Windows.

---

📝 License

MIT License © 2026 Ali Sadeghi Aghili