Skip to content

Restructure to single package with docs site#24

Merged
Wenyueh merged 8 commits intomainfrom
refactor/single-package
Mar 20, 2026
Merged

Restructure to single package with docs site#24
Wenyueh merged 8 commits intomainfrom
refactor/single-package

Conversation

@TianyiPeng
Copy link
Copy Markdown
Collaborator

@TianyiPeng TianyiPeng commented Mar 20, 2026

Summary

  • Single package: Merge agentproxy into agentopt.proxy subpackage — no more monorepo confusion
  • Flat layout: Move agentopt/src/agentopt/ to src/agentopt/, remove separate pyproject.toml files
  • Documentation site: Full mkdocs-material site with getting started guide, concept docs (architecture, algorithms, caching), framework examples (OpenAI, LangChain, CrewAI, LlamaIndex), and API reference
  • README rewrite: Focused on the core value prop — finding the right LLM models for your agents
  • All imports updated: from agentproxyfrom agentopt.proxy across source, tests, and examples
  • 45 tests passing

What changed

Before After
agentopt/ + agentproxy/ (two packages) src/agentopt/ (single package)
agentproxy.LLMTracker agentopt.proxy.LLMTracker
Two pyproject.toml files One unified pyproject.toml
Internal design docs Public mkdocs-material documentation site

Test plan

  • uv run pytest — 45 tests passing
  • uv run mkdocs serve — docs site builds and serves locally
  • Verify pip install -e . works with the new layout
  • Verify examples run with updated imports

🤖 Generated with Claude Code

TianyiPeng and others added 8 commits March 19, 2026 16:29
- Merge agentproxy into agentopt.proxy subpackage
- Flatten to single src/agentopt/ layout (no more triple-nested dirs)
- Single pyproject.toml with all dependencies
- Update all imports: agentproxy -> agentopt.proxy
- Rewrite README focused on "finding the right models for your agents"
- Add mkdocs-material documentation site with:
  - Getting started (install + quickstart)
  - Concepts (how it works, algorithms, caching)
  - Framework examples (OpenAI, LangChain, CrewAI, LlamaIndex)
  - API reference (selectors, results, tracker)
- Remove old design docs (content moved to docs site)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- Add custom CSS with hero section, feature cards, gradient heading
- Enable navigation tabs, instant loading, mermaid diagrams, search suggestions
- Rewrite landing page with problem/solution structure and feature grid
- Add admonitions, parameter tables, and tabbed content across all pages
- Rename litellm_config_optimized.yaml to examples/optimized_config.yaml

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Icons were rendering as raw text because emoji wasn't processed
inside custom HTML divs. Switch to native grid cards syntax.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Resolve merge conflicts:
- README.md: keep refactor branch version (single-package structure)
- docs/model-selection-design.md: accept deletion (replaced by mkdocs)
- src/agentopt/model_selection/hyperband.py: accept deletion (PR #26)

Clean up remaining hyperband references in README and docs that
were introduced by the refactor branch after PR #26 landed on main.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@Wenyueh Wenyueh merged commit 1b61bcc into main Mar 20, 2026
@Wenyueh Wenyueh deleted the refactor/single-package branch March 22, 2026 04:16
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