Skip to main content

Documentation Index

Fetch the complete documentation index at: https://authsome.agentr.dev/docs/llms.txt

Use this file to discover all available pages before exploring further.

LlamaIndex connects LLMs to your data through loaders, indexes, and retrievers. Each of those typically needs a credential (LLM API key, data-source token). Run the script under authsome’s proxy and the loaders just work.

​
Run the whole script under the proxy

uvx authsome login openai
uvx authsome login github
uvx authsome run -- python my_index.py
LlamaIndex’s HTTP clients see OPENAI_API_KEY=authsome-proxy-managed and similar placeholders. The proxy injects the real value for outbound requests to matched provider hosts. No code changes needed in your script.

​
Data-loader credentials

LlamaIndex’s data readers cover dozens of services (Notion, Confluence, Slack, Google Drive, etc.). For each one:
  • Check uvx authsome list for the matching provider name.
  • If bundled, log in: uvx authsome login <provider>.
  • Run your script under uvx authsome run --. The reader picks the credential up from its standard env var.
For services not bundled, see Custom providers.

​
Embedding the library

If you’re building a larger orchestrator around LlamaIndex and need explicit per-call control: 
from authsome.server.dependencies import create_auth_service
from llama_index.core import Settings
from llama_index.llms.openai import OpenAI
from llama_index.readers.github import GithubRepositoryReader, GithubClient

auth = create_auth_service()

Settings.llm = OpenAI(api_key=auth.get_access_token("openai"))

reader = GithubRepositoryReader(
    github_client=GithubClient(auth.get_access_token("github")),
    owner="agentrhq",
    repo="authsome",
)
docs = reader.load_data(branch="main")
Refresh is silent. Re-call get_access_token if your process lives long enough to outlast a token’s TTL.

​
Multi-account

docs_personal = reader_personal.load_data()
docs_work = reader_work.load_data()
with: 
auth.get_access_token("github", connection="personal")
auth.get_access_token("github", connection="work")
See Multiple connections per provider.

​
What’s next

Python library

AuthService and the auth-layer API.

Custom providers

Add a data-source provider authsome doesn’t ship.