chore: add community files, extended tests, and README polish

- Add CODE_OF_CONDUCT.md (Contributor Covenant v2.1)
- Add PULL_REQUEST_TEMPLATE.md with checklist
- Add requirements.txt (requests>=2.20, pydantic>=2.0)
- Add CHANGELOG compare links for all versions
- Add README Table of Contents, Screenshots placeholder, Troubleshooting/FAQ
- Fix error prefix consistency in empty response message
- Add 39 new unit tests (234 total): _is_safe_url, _clean_model_id,
  model caching, base URL validator, pipe() guards, fallback attribution,
  citation edge cases, pipes() edge cases
- Update test counts (195->234) across all docs
- Update Project Structure to include new files
- Update CONTRIBUTING prerequisites with version numbers

Author: sena-labs

.github/CODE_OF_CONDUCT.md

@@ -0,0 +1,135 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, caste, color, religion, or sexual
+identity and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming,
+diverse, inclusive, and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment for our
+community include:
+
+- Demonstrating empathy and kindness toward other people
+- Being respectful of differing opinions, viewpoints, and experiences
+- Giving and gracefully accepting constructive feedback
+- Accepting responsibility and apologizing to those affected by our mistakes,
+  and learning from the experience
+- Focusing on what is best not just for us as individuals, but for the overall
+  community
+
+Examples of unacceptable behavior include:
+
+- The use of sexualized language or imagery, and sexual attention or advances of
+  any kind
+- Trolling, insulting or derogatory comments, and personal or political attacks
+- Public or private harassment
+- Publishing others' private information, such as a physical or email address,
+  without their explicit permission
+- Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Enforcement Responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of
+acceptable behavior and will take appropriate and fair corrective action in
+response to any behavior that they deem inappropriate, threatening, offensive,
+or harmful.
+
+Community leaders have the right and responsibility to remove, edit, or reject
+comments, commits, code, wiki edits, issues, and other contributions that are
+not aligned to this Code of Conduct, and will communicate reasons for moderation
+decisions when appropriate.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when
+an individual is officially representing the community in public spaces.
+Examples of representing our community include using an official email address,
+posting via an official social media account, or acting as an appointed
+representative at an online or offline event.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the community leaders responsible for enforcement via
+[GitHub Issues](https://github.com/sena-labs/OpenRouter-Pipe/issues) or by
+contacting the maintainers through
+[GitHub private vulnerability reporting](https://github.com/sena-labs/OpenRouter-Pipe/security/advisories/new).
+
+All complaints will be reviewed and investigated promptly and fairly.
+
+All community leaders are obligated to respect the privacy and security of the
+reporter of any incident.
+
+## Enforcement Guidelines
+
+Community leaders will follow these Community Impact Guidelines in determining
+the consequences for any action they deem in violation of this Code of Conduct:
+
+### 1. Correction
+
+**Community Impact**: Use of inappropriate language or other behavior deemed
+unprofessional or unwelcome in the community.
+
+**Consequence**: A private, written warning from community leaders, providing
+clarity around the nature of the violation and an explanation of why the
+behavior was inappropriate. A public apology may be requested.
+
+### 2. Warning
+
+**Community Impact**: A violation through a single incident or series of
+actions.
+
+**Consequence**: A warning with consequences for continued behavior. No
+interaction with the people involved, including unsolicited interaction with
+those enforcing the Code of Conduct, for a specified period of time. This
+includes avoiding interactions in community spaces as well as external channels
+like social media. Violating these terms may lead to a temporary or permanent
+ban.
+
+### 3. Temporary Ban
+
+**Community Impact**: A serious violation of community standards, including
+sustained inappropriate behavior.
+
+**Consequence**: A temporary ban from any sort of interaction or public
+communication with the community for a specified period of time. No public or
+private interaction with the people involved, including unsolicited interaction
+with those enforcing the Code of Conduct, is allowed during this period.
+Violating these terms may lead to a permanent ban.
+
+### 4. Permanent Ban
+
+**Community Impact**: Demonstrating a pattern of violation of community
+standards, including sustained inappropriate behavior, harassment of an
+individual, or aggression toward or disparagement of classes of individuals.
+
+**Consequence**: A permanent ban from any sort of public interaction within the
+community.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 2.1, available at
+[https://www.contributor-covenant.org/version/2/1/code_of_conduct.html][v2.1].
+
+Community Impact Guidelines were inspired by
+[Mozilla's code of conduct enforcement ladder][Mozilla CoC].
+
+For answers to common questions about this code of conduct, see the FAQ at
+[https://www.contributor-covenant.org/faq][FAQ]. Translations are available at
+[https://www.contributor-covenant.org/translations][translations].
+
+[homepage]: https://www.contributor-covenant.org
+[v2.1]: https://www.contributor-covenant.org/version/2/1/code_of_conduct.html
+[Mozilla CoC]: https://github.com/mozilla/diversity
+[FAQ]: https://www.contributor-covenant.org/faq
+[translations]: https://www.contributor-covenant.org/translations

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,29 @@
+## Description
+
+<!-- Brief description of the changes in this PR -->
+
+## Type of Change
+
+- [ ] Bug fix (non-breaking change that fixes an issue)
+- [ ] New feature (non-breaking change that adds functionality)
+- [ ] Breaking change (fix or feature that would cause existing functionality to not work as expected)
+- [ ] Documentation update
+- [ ] Refactoring (no functional changes)
+
+## Checklist
+
+- [ ] I have read the [CONTRIBUTING.md](../CONTRIBUTING.md) guidelines
+- [ ] All tests pass (`python test_pipe.py` — 234/234 ✓)
+- [ ] I have added tests for new functionality (if applicable)
+- [ ] I have updated `CHANGELOG.md` under `[Unreleased]`
+- [ ] I have updated documentation (if applicable)
+- [ ] My code follows the project's code style (PEP 8, type hints)
+- [ ] No secrets, API keys, or credentials are included in this PR
+
+## Related Issues
+
+<!-- Link any related issues: Fixes #123, Closes #456 -->
+
+## Additional Notes
+
+<!-- Any additional context, screenshots, or information -->

CHANGELOG.md

@@ -116,3 +116,11 @@ No unreleased changes.
 - Streaming and non-streaming chat completions
 - Basic error handling and timeout configuration
 - Model prefix customization
+
+<!-- Compare links -->
+[Unreleased]: https://github.com/sena-labs/OpenRouter-Pipe/compare/v1.2.0...HEAD
+[1.2.0]: https://github.com/sena-labs/OpenRouter-Pipe/compare/v1.1.1...v1.2.0
+[1.1.1]: https://github.com/sena-labs/OpenRouter-Pipe/compare/v1.1.0...v1.1.1
+[1.1.0]: https://github.com/sena-labs/OpenRouter-Pipe/compare/v1.0.0...v1.1.0
+[1.0.0]: https://github.com/sena-labs/OpenRouter-Pipe/compare/v0.1.0...v1.0.0
+[0.1.0]: https://github.com/sena-labs/OpenRouter-Pipe/releases/tag/v0.1.0

CONTRIBUTING.md

@@ -17,13 +17,19 @@ python test_pipe.py
 ### Prerequisites
 
 - Python 3.10+
-- `requests` library
-- `pydantic` library
+- `requests` >= 2.20
+- `pydantic` >= 2.0
+
+Install dependencies:
+
+```bash
+pip install -r requirements.txt
+```
 
 ### Running Tests
 
 ```bash
-python test_pipe.py           # Unit tests (195 tests)
+python test_pipe.py           # Unit tests (234 tests)
 python integration_test.py    # Live API tests (requires OPENROUTER_API_KEY)
 ```
 

README.md

@@ -21,6 +21,23 @@ Provider routing · Reasoning tokens · Streaming · Fallbacks · Cache control
 
 ---
 
+## Table of Contents
+
+- [Why OpenRouter Pipe?](#why-openrouter-pipe)
+- [Screenshots](#screenshots)
+- [Quick Start](#quick-start)
+- [Features](#features)
+- [Configuration](#configuration)
+- [API Reference](#api-reference)
+- [Compatibility](#compatibility)
+- [Project Structure](#project-structure)
+- [Testing](#testing)
+- [Troubleshooting](#troubleshooting)
+- [Contributing](#contributing)
+- [License](#license)
+
+---
+
 ## Why OpenRouter Pipe?
 
 OpenRouter Pipe is the most feature-complete integration between [Open WebUI](https://docs.openwebui.com) and [OpenRouter](https://openrouter.ai). It gives you access to **300+ AI models** — including GPT-5, Claude 4, Gemini 2.5, Llama 4, DeepSeek R1, and more — directly in your Open WebUI interface, with zero configuration beyond an API key.
@@ -34,6 +51,20 @@ OpenRouter Pipe is the most feature-complete integration between [Open WebUI](ht
 
 ---
 
+## Screenshots
+
+<!-- TODO: Add screenshots of the pipe in action -->
+<!-- Suggested screenshots:
+  1. Model selector showing OpenRouter models with provider icons
+  2. Streaming response with <think> reasoning blocks
+  3. Valve configuration panel in Open WebUI admin
+  4. Fallback model attribution ("Responded by: ...")
+-->
+
+*Screenshots coming soon — contributions welcome!*
+
+---
+
 ## Quick Start
 
 ### Prerequisites
@@ -184,7 +215,7 @@ It also removes `user` when sent as a dict (OWUI format) since OpenRouter expect
 OpenRouter-Pipe/
 ├── openrouter_pipe.py      # Main pipe source (install this in Open WebUI)
 ├── function.json           # Open WebUI community manifest (metadata, tags, categories)
-├── test_pipe.py            # Unit test suite (195 tests)
+├── test_pipe.py            # Unit test suite (234 tests)
 ├── integration_test.py     # Live API integration tests (47 tests)
 ├── TESTING.md              # Pre-release testing checklist
 ├── SECURITY.md             # Security policy and vulnerability reporting
@@ -193,8 +224,11 @@ OpenRouter-Pipe/
 ├── CONTRIBUTING.md         # Contribution guidelines
 ├── LICENSE                 # MIT License
 ├── .gitignore              # Git ignore rules
+├── requirements.txt        # Python dependencies
 └── .github/
     ├── FUNDING.yml          # GitHub Sponsors configuration
+    ├── CODE_OF_CONDUCT.md   # Contributor Covenant v2.1
+    ├── PULL_REQUEST_TEMPLATE.md  # PR checklist template
     ├── workflows/
     │   └── tests.yml        # CI pipeline (Python 3.10–3.13)
     └── ISSUE_TEMPLATE/
@@ -223,6 +257,55 @@ Tests cover:
 
 ---
 
+## Troubleshooting
+
+<details>
+<summary><strong>"OpenRouter API key not configured"</strong></summary>
+
+Set your API key in **Admin Panel → Functions → OpenRouter Pipe → Valves** (⚙️ icon), or set the `OPENROUTER_API_KEY` environment variable on the server.
+</details>
+
+<details>
+<summary><strong>"Invalid API key (HTTP 401/502)"</strong></summary>
+
+Your API key is incorrect or malformed. Get a valid key from [openrouter.ai/keys](https://openrouter.ai/keys) and make sure it starts with `sk-or-`.
+</details>
+
+<details>
+<summary><strong>"Rate limit exceeded (HTTP 429)"</strong></summary>
+
+You're sending too many requests. Wait a moment and try again. Consider setting `MAX_RETRIES` to `2` or higher for automatic backoff.
+</details>
+
+<details>
+<summary><strong>"Insufficient credits (HTTP 402)"</strong></summary>
+
+Your OpenRouter account balance is too low. Add credits at [openrouter.ai/credits](https://openrouter.ai/credits).
+</details>
+
+<details>
+<summary><strong>"Request timed out"</strong></summary>
+
+The model took too long to respond. Increase `REQUEST_TIMEOUT` in the valve settings (default: 90 seconds), or try a different model.
+</details>
+
+<details>
+<summary><strong>No models showing in the selector</strong></summary>
+
+1. Check that your API key is valid
+2. If using `MODEL_PROVIDERS`, verify the provider names are correct (e.g., `openai`, `anthropic`, `google`)
+3. If `FREE_ONLY` is enabled, some providers may not have free models available
+4. Try setting `MODEL_PROVIDERS` to `ALL` to see all models
+</details>
+
+<details>
+<summary><strong>Models load but chat returns errors</strong></summary>
+
+Some models may be temporarily unavailable on OpenRouter. Try a different model or check [OpenRouter Status](https://status.openrouter.ai).
+</details>
+
+---
+
 ## Contributing
 
 Contributions are welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for details.

TESTING.md

@@ -12,7 +12,7 @@ Manual checklist to verify every Pipe feature before release.
 python test_pipe.py
 ```
 
-Must print **195/195 passed**. If any test fails, **do not release**.
+Must print **234/234 passed**. If any test fails, **do not release**.
 
 ---
 
@@ -191,7 +191,7 @@ Must print **195/195 passed**. If any test fails, **do not release**.
 ## Quick pre-release checklist
 
 ```
-[ ] python test_pipe.py → 195/195 ✓
+[ ] python test_pipe.py → 234/234 ✓
 [ ] python integration_test.py → 47/47 ✓
 [ ] Empty API key → clear error
 [ ] Valid API key → 340+ models

openrouter_pipe.py

@@ -583,7 +583,7 @@ def _non_stream_response(self, headers: dict, payload: dict) -> str:
                 return f"OpenRouter Error: {msg}"
 
             if not res.get("choices"):
-                return "OpenRouter returned an empty response. The model may be temporarily unavailable."
+                return "OpenRouter Error: Empty response. The model may be temporarily unavailable."
             choice = res["choices"][0]
             message = choice.get("message", {})
             citations = res.get("citations", [])

requirements.txt

@@ -0,0 +1,2 @@
+requests>=2.20
+pydantic>=2.0