Skip to content

docs: add an API key setup guide for every LLM provider - #269

Merged
himanshu231204 merged 2 commits into
OpenAgentHQ:mainfrom
Nitjsefnie-OSC:docs/110-provider-api-key-guide
Aug 1, 2026
Merged

docs: add an API key setup guide for every LLM provider#269
himanshu231204 merged 2 commits into
OpenAgentHQ:mainfrom
Nitjsefnie-OSC:docs/110-provider-api-key-guide

Conversation

@Nitjsefnie

Copy link
Copy Markdown
Contributor

Description

Closes #110. Adds docs/providers/llm/api-key-setup.md — one section per provider with the exact environment variable the code reads, where to get the key, and a minimal working example.

Every variable and default model was read out of the provider source, not from general knowledge, because a key guide that names a variable the code does not read is worse than no guide — it sends people to set something that has no effect. The cites:

Provider Env var Default model Read from
OpenAI OPENAI_API_KEY gpt-4o providers/llm/openai.py:114, :120
Anthropic ANTHROPIC_API_KEY claude-sonnet-4-20250514 providers/llm/anthropic.py:121
Gemini GEMINI_API_KEY gemini-2.5-flash providers/llm/gemini.py:128
Groq GROQ_API_KEY llama-3.3-70b-versatile providers/llm/groq.py:113, :120
OpenRouter OPENROUTER_API_KEY openai/gpt-4o-mini providers/llm/openrouter.py:117
Ollama none llama3.2 no key read; base_url defaults to http://localhost:11434 at providers/llm/ollama.py:108
Mock none mock-model no key read (providers/llm/mock.py:33)

Ollama and Mock are documented as keyless rather than omitted, since "which ones need no key" is exactly what a reader of this page is trying to find out. No provider support was invented.

Type of Change

  • Documentation update

Related Issues

Closes #110

How Has This Been Tested?

mkdocs build --strict builds clean with the new page registered under Providers → LLM in mkdocs.yml.

One honest note on that run: --strict also emits "pages exist in the docs directory but are not included in nav" for a set of files (01_vision.md, 02_problem_statement.md, examples.md, others). Those are pre-existing and unrelated to this page — they are already unregistered on main. I did not add them to the nav, since deciding what belongs in your navigation is your call, not a side effect of a docs PR.

Generated by Claude Opus 5 (brief, review), Kimi K2.7 Code (implementation)

Nitjsefnie and others added 2 commits August 1, 2026 14:22
Add a single reference page that lists the exact environment variable
each hosted LLM provider reads, where to get each key, and a minimal
config.yaml example. Register the page under the LLM providers section
in mkdocs.yml.

Co-Authored-By: Kimi K2.7 Code <noreply@kimi.com>
@himanshu231204
himanshu231204 merged commit 2ad932b into OpenAgentHQ:main Aug 1, 2026
9 checks passed
@github-actions

github-actions Bot commented Aug 1, 2026

Copy link
Copy Markdown

🎉 Congratulations @Nitjsefnie!

Your pull request has been successfully merged into main. 🚀

Thank you for contributing to OpenAgentHQ and helping improve the project.

We truly appreciate your contribution and hope to see you back with more amazing PRs!

Happy Open Sourcing! ❤️

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.

Add API key setup guide for all LLM providers to docs

2 participants