Skip to content

doc: updated roadmap and quick start#24

Merged
SantiagoDePolonia merged 6 commits intomainfrom
doc/roadmap-and-general-update
Dec 28, 2025
Merged

doc: updated roadmap and quick start#24
SantiagoDePolonia merged 6 commits intomainfrom
doc/roadmap-and-general-update

Conversation

@SantiagoDePolonia
Copy link
Copy Markdown
Contributor

@SantiagoDePolonia SantiagoDePolonia commented Dec 28, 2025

Summary by CodeRabbit

  • Documentation
    • Added a “Running Manually” subsection with instructions to create an env file from the template
    • Clarified Option A to note creation based on the .env template and generalized required API keys note
    • Updated example/test payloads to use model gpt-5-nano
    • Added “Running with Docker” and “Running with Docker Compose” sections with explicit commands and notes
    • Replaced prior Docker-centric run guidance with integrated Pre-commit guidance and reorganized run instructions
    • Added top-level Roadmap, Supported Providers, Features, and Integrations sections and tables

✏️ Tip: You can customize this high-level summary in your review settings.

@SantiagoDePolonia SantiagoDePolonia self-assigned this Dec 28, 2025
@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai bot commented Dec 28, 2025

Caution

Review failed

The pull request is closed.

Note

Other AI code review bot(s) detected

CodeRabbit has detected other AI code review bot(s) in this pull request and will avoid duplicating their findings in the review comments. This may lead to a less comprehensive review.

📝 Walkthrough

Walkthrough

Updated README.md: added "Running Manually", Docker, and Docker Compose instructions; clarified .env usage and API key requirements; introduced Pre-commit guidance; changed example model to gpt-5-nano; and added Roadmap, Supported Providers, Features, and Integrations sections with tables.

Changes

Cohort / File(s) Summary
Documentation — README
README.md
Added "Running Manually" section with .env.template guidance and export options; clarified Option A wording; generalized required API keys note; switched test/examples to gpt-5-nano; added "Running with Docker" and "Running with Docker Compose" commands; moved run guidance to a Pre-commit subsection; added Roadmap, Supported Providers, Features, and Integrations tables; assorted wording/layout adjustments.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Possibly related PRs

  • doc: updated roadmap and quick start #24 — Mirrors README-level changes (Running Manually/Docker/Compose sections, example model switch to gpt-5-nano, Pre-commit guidance, Roadmap/Providers additions).

Poem

🐰 I nibbled through the README night,
I added guides to run things right,
Docker, compose, and pre-commit cheer,
A newer model hopping near —
Hop in, press go, the path is bright! 🥕

Pre-merge checks and finishing touches

✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title accurately reflects the main changes in the pull request, which include updates to the README documentation focusing on roadmap additions and quick start section improvements.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

📜 Recent review details

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between f547b7a and 033c366.

📒 Files selected for processing (1)
  • README.md

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 10

📜 Review details

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between e4ebd44 and 69b2bbf.

📒 Files selected for processing (1)
  • README.md
🧰 Additional context used
🪛 LanguageTool
README.md

[style] ~61-~61: As an alternative to the over-used intensifier ‘really’, consider replacing this phrase.
Context: ...r", "content": "Hello!"}]}' ``` ### Really quick start With docker To be added... ## D...

(EN_WEAK_ADJECTIVE)

🔇 Additional comments (5)
README.md (5)

11-27: LGTM!

The environment setup instructions are clear, well-structured with two practical options, and the note about minimum API key requirements is helpful.


90-97: LGTM!

The pre-commit installation instructions are clear, well-documented, and include a helpful link to official documentation. Good addition to the development section.


11-27: LGTM!

The environment setup is well-structured with two practical options and clear guidance about minimum API key requirements.


90-97: LGTM!

The pre-commit installation instructions are clear and include a helpful link to official documentation.


104-104: No action needed—make build target is properly defined in the Makefile (line 4) and declared in .PHONY. The command will execute successfully without errors.

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR updates the README documentation to enhance the Quick Start guide and expand the roadmap section. The changes reorganize content to improve clarity and add detailed feature tracking tables.

  • Restructured Quick Start section with separate subsections for manual, Docker, and Docker Compose execution methods
  • Added comprehensive roadmap tables tracking provider support, features, and integrations
  • Moved Pre-commit setup guidance to the Development section

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

README.md Outdated
| Feature | Basic support | Full support |
| -------------------------- | ----------------- | ----------------- |
| Billing Management | 🚧 Coming soon... | 🚧 Coming soon... |
| Full-observibility | 🚧 Coming soon... | 🚧 Coming soon... |
Copy link

Copilot AI Dec 28, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The word "observibility" is misspelled. The correct spelling is "observability".

Suggested change
| Full-observibility | 🚧 Coming soon... | 🚧 Coming soon... |
| Full-observability | 🚧 Coming soon... | 🚧 Coming soon... |

Copilot uses AI. Check for mistakes.
curl http://localhost:8080/v1/chat/completions \
-H "Content-Type: application/json" \
-d '{"model": "gpt-4o-mini", "messages": [{"role": "user", "content": "Hello!"}]}'
-d '{"model": "gpt-5-nano", "messages": [{"role": "user", "content": "Hello!"}]}'
Copy link

Copilot AI Dec 28, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The model name "gpt-5-nano" does not exist. As of January 2025, OpenAI has not released GPT-5 or any model called "gpt-5-nano". The previous value "gpt-4o-mini" was correct and should be retained, or use another valid OpenAI model like "gpt-4o" or "gpt-3.5-turbo".

Suggested change
-d '{"model": "gpt-5-nano", "messages": [{"role": "user", "content": "Hello!"}]}'
-d '{"model": "gpt-4o-mini", "messages": [{"role": "user", "content": "Hello!"}]}'

Copilot uses AI. Check for mistakes.
Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

📜 Review details

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 9120147 and f547b7a.

📒 Files selected for processing (1)
  • README.md
⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (1)
  • GitHub Check: Analyze (go)
🔇 Additional comments (4)
README.md (4)

7-57: Good improvements to setup documentation.

The "Running Manually" section is well-structured with clear step-by-step instructions, proper environment variable setup options, and working test examples. Properly addresses the previous feedback about heading clarity and placeholder content.


59-76: Docker section is complete and practical.

The "Running with Docker" section provides clear, ready-to-use commands with proper documentation. Properly resolves the earlier placeholder issue.


111-118: Pre-commit section is clear and helpful.

Good addition providing clear setup instructions with links to official documentation. This supports development best practices.


120-131: Supported Providers table is properly structured.

The duplicate column header issue from the previous review is now resolved—the second occurrence is correctly labeled "Video gen" instead of duplicating "Image gen". All column headers are now unique and descriptive.

Comment on lines +133 to +152
## Features

| Feature | Basic support | Full support |
| -------------------------- | ----------------- | ----------------- |
| Billing Management | 🚧 Coming soon... | 🚧 Coming soon... |
| Full-observibility | 🚧 Coming soon... | 🚧 Coming soon... |
| Budget management | 🚧 Coming soon... | 🚧 Coming soon... |
| Many keys support | 🚧 Coming soon... | 🚧 Coming soon... |
| Administrative endpoints | 🚧 Coming soon... | 🚧 Coming soon... |
| Guardrails | 🚧 Coming soon... | 🚧 Coming soon... |
| SSO | 🚧 Coming soon... | 🚧 Coming soon... |
| System Prompt (GuardRails) | 🚧 Coming soon... | 🚧 Coming soon... |

## Integrations

| Integration | Basic integration | Full support |
| ------------- | ----------------- | ----------------- |
| Prometheus | ✅ | 🚧 Coming soon... |
| DataDog | 🚧 Coming soon... | 🚧 Coming soon... |
| OpenTelemetry | 🚧 Coming soon... | 🚧 Coming soon... |
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🧹 Nitpick | 🔵 Trivial

Clarify roadmap sections to set user expectations about feature availability.

The Features and Integrations tables display primarily "Coming soon" items. While appropriate for a roadmap document, consider clarifying that these sections represent planned features, not current capabilities. Currently, the headers "## Features" and "## Integrations" may suggest these are available today.

A simple improvement: add a brief introductory line before each section (e.g., "### Features (Roadmap)" or "The following features are planned for future releases:") to clearly distinguish current support from planned work.

🤖 Prompt for AI Agents
In README.md around lines 133 to 152, the "Features" and "Integrations" sections
currently list mostly "Coming soon" items and can be misread as available now;
add a single clarifying sentence or change the section headers to indicate these
are planned/roadmap items (e.g., "Features (Roadmap)" or "The following features
are planned for future releases:") before each table so readers clearly
understand these entries are not yet implemented.

@SantiagoDePolonia SantiagoDePolonia merged commit d63cae8 into main Dec 28, 2025
3 of 4 checks passed
@SantiagoDePolonia SantiagoDePolonia deleted the doc/roadmap-and-general-update branch March 22, 2026 14:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants