docs: extend documentation with comprehensive usage examples and environment config

aider_gitea/__init__.py

@@ -20,6 +20,43 @@ python -m aider_gitea
 
 # Specify custom repository and owner
 python -m aider_gitea --owner myorg --repo myproject
+
+# Use a custom Gitea URL
+python -m aider_gitea --gitea-url https://gitea.example.com
+
+# Specify a different base branch
+python -m aider_gitea --base-branch develop
+```
+
+### Python API
+
+```python
+from aider_gitea import solve_issue_in_repository
+from pathlib import Path
+
+# Solve an issue programmatically
+args = argparse.Namespace(
+    gitea_url="https://gitea.example.com",
+    owner="myorg",
+    repo="myproject",
+    base_branch="main"
+)
+
+solve_issue_in_repository(
+    args,
+    Path("/path/to/repo"),
+    "issue-123-fix-bug",
+    "Fix critical bug",
+    "The application crashes when processing large files",
+    "123"
+)
+```
+
+### Environment Configuration
+
+The tool uses environment variables for sensitive information:
+- `GITEA_TOKEN`: Your Gitea API token
+- `LLM_API_KEY`: API key for the language model used by Aider
 ```
 """