Skip to content

Conversation

@roomote
Copy link

@roomote roomote bot commented Oct 27, 2025

Description

This PR attempts to address Issue #8856 by adding a prominent Free Trial section to help users get started with Roo Code quickly and easily.

Changes

  • ✨ Created comprehensive FREE_TRIAL_SETUP.md with step-by-step instructions for multiple providers
  • 📝 Added prominent "Free Trial" section near the top of README for maximum visibility
  • 📊 Included provider comparison table with free credits information
  • 🔧 Added troubleshooting section to help users resolve common setup issues
  • 📚 Provided setup guides for OpenRouter, Google Gemini, and Groq (providers with free tiers)

Benefits

  • Easier onboarding: New users can get started in under 2 minutes
  • No credit card required: Multiple free tier options available
  • Clear guidance: Step-by-step instructions with screenshots links
  • Provider flexibility: Users can choose the provider that best fits their needs

Testing

  • ✅ All linting checks pass
  • ✅ Documentation follows existing markdown conventions
  • ✅ Links verified to point to correct provider URLs

Related Issues

Fixes #8856

Screenshots

The new Free Trial section appears prominently in the README:

  • Right after the language selection dropdown
  • Before the "What Can Roo Code Do For YOU?" section

Feedback and guidance are welcome!


Important

Adds a Free Trial section to README and a detailed setup guide in FREE_TRIAL_SETUP.md for quick onboarding with free AI provider trials.

  • Documentation:
    • Adds FREE_TRIAL_SETUP.md with setup instructions for OpenRouter, Google Gemini, and Groq.
    • Includes provider comparison table and troubleshooting tips in FREE_TRIAL_SETUP.md.
    • Adds a "Free Trial" section to README.md with a link to the setup guide.
  • Features:
    • Provides step-by-step setup instructions for multiple providers with free tiers.
    • Highlights no credit card requirement and quick setup time.
  • Misc:

This description was created by Ellipsis for 0ef2292. You can customize this summary. It will automatically update as commits are pushed.

- Created comprehensive FREE_TRIAL_SETUP.md with step-by-step instructions
- Added Free Trial section at the top of README for better visibility
- Included setup guides for OpenRouter, Google Gemini, and Groq
- Provided provider comparison table with free credits information
- Added troubleshooting section and helpful tips

Fixes #8856
@roomote roomote bot requested review from cte, jr and mrubens as code owners October 27, 2025 07:38
@dosubot dosubot bot added the size:L This PR changes 100-499 lines, ignoring generated files. label Oct 27, 2025
@roomote
Copy link
Author

roomote bot commented Oct 27, 2025

Review Summary

All previously identified issues have been resolved:

Issues Fixed

  • Update OpenRouter model recommendation from claude-3.5-sonnet to anthropic/claude-3.5-sonnet (line 18 in FREE_TRIAL_SETUP.md)
  • Update Groq model recommendation from llama-3.1-70b to either llama-3.3-70b-versatile or moonshotai/kimi-k2-instruct-0905 (line 46 in FREE_TRIAL_SETUP.md)

The documentation now accurately references model IDs that match the provider configurations in the codebase.


View Job

@dosubot dosubot bot added the documentation Improvements or additions to documentation label Oct 27, 2025
- Type "Roo Code: Open Settings"
- Select "OpenRouter" as your provider
- Paste your API key
- Choose a model (we recommend `claude-3.5-sonnet` for best results)
Copy link
Author

Choose a reason for hiding this comment

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

The recommended model ID claude-3.5-sonnet is incomplete for OpenRouter. OpenRouter requires the full model ID with provider prefix. Based on the codebase model definitions, this should be anthropic/claude-3.5-sonnet to match the actual available models in the system.

- Type "Roo Code: Open Settings"
- Select "Groq" as your provider
- Paste your API key
- Choose `llama-3.1-70b` for best performance
Copy link
Author

Choose a reason for hiding this comment

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

The recommended model llama-3.1-70b doesn't exist in the Groq provider configuration. The codebase shows that Groq's default model is moonshotai/kimi-k2-instruct-0905, and available models include llama-3.1-8b-instant and llama-3.3-70b-versatile (not llama-3.1-70b). Consider recommending llama-3.3-70b-versatile for best performance or moonshotai/kimi-k2-instruct-0905 as it's the default.

@hannesrudolph hannesrudolph added the Issue/PR - Triage New issue. Needs quick review to confirm validity and assign labels. label Oct 27, 2025
@laz-001
Copy link

laz-001 commented Oct 27, 2025

@roomote , i like your approach, as it can be applied immediately without any coding, and will have immediate effect. In a later step, this could be automated (e.g. create ONE account, get the free tiers automatically, without setup - as the original issue intended). One remark: maybe you could remove your color-emojis from the docs you created, thus it looks more professional.

@roomote
Copy link
Author

roomote bot commented Oct 27, 2025

Thanks @laz-001 for the thoughtful feedback. Agreed on removing color emojis to keep the docs professional. I will update README.md and FREE_TRIAL_SETUP.md to remove color emojis and align tone. I will also update the model IDs noted earlier for OpenRouter and Groq so the guidance matches current provider configs. I will push changes to feature/free-trial-setup-docs shortly and follow up here.

Copy link
Author

@roomote roomote bot left a comment

Choose a reason for hiding this comment

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

No issues found.

@roomote
Copy link
Author

roomote bot commented Oct 27, 2025

Summary of updates in response to feedback:

  • Removed color emojis from docs for a more professional tone:
  • Updated model recommendations to match current provider configs:
    • OpenRouter: claude-3.5-sonnetanthropic/claude-3.5-sonnet
    • Groq: llama-3.1-70bllama-3.3-70b-versatile
  • Changes pushed to feature/free-trial-setup-docs; all PR checks are passing.

@laz-001 If you prefer that I also include moonshotai/kimi-k2-instruct-0905 as an alternative Groq recommendation, I can add it.

@daniel-lxs daniel-lxs closed this Oct 29, 2025
@github-project-automation github-project-automation bot moved this from Triage to Done in Roo Code Roadmap Oct 29, 2025
@github-project-automation github-project-automation bot moved this from New to Done in Roo Code Roadmap Oct 29, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation Issue/PR - Triage New issue. Needs quick review to confirm validity and assign labels. size:L This PR changes 100-499 lines, ignoring generated files.

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

[ENHANCEMENT] Provide Simple "Free Trial" Setup

5 participants