Metadata-Version: 2.4
Name: openseed
Version: 0.2.0
Summary: AI-powered Research Workflow Management CLI
License-Expression: MIT
Requires-Python: >=3.11
Requires-Dist: anthropic>=0.70
Requires-Dist: claude-agent-sdk>=0.1
Requires-Dist: click>=8.1
Requires-Dist: httpx>=0.27
Requires-Dist: pydantic>=2.0
Requires-Dist: pymupdf>=1.24
Requires-Dist: pypdf2>=3.0
Requires-Dist: rich>=13.0
Requires-Dist: toml>=0.10
Provides-Extra: dev
Requires-Dist: mypy>=1.10; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: ruff>=0.4; extra == 'dev'
Description-Content-Type: text/markdown

# OpenSeed

AI-powered research CLI — discover, read, and analyze academic papers with Claude.

## What it does

- **Smart search** — finds relevant papers via Claude WebSearch, ranks by real citation counts (Semantic Scholar)
- **Analysis pipeline** — search → pick papers → auto-summarize + auto-tag → save to library in one flow
- **AI summarization** — structured summaries: key contributions, methodology, limitations, relevance score
- **Experiment code gen** — generate runnable PyTorch/sklearn experiment code from a paper
- **Library management** — ArXiv import, tags, reading status, deduplication

## Search

![openseed paper search "attention"](screenshot-20260317-144253.png)

Papers are ranked by real citation counts fetched from Semantic Scholar — not keyword matching.

## Install

```bash
pip install -e ".[dev]"
openseed doctor    # check environment
openseed setup     # configure auth
```

**Auth** — any of these work:

```bash
export ANTHROPIC_API_KEY=sk-ant-...   # Anthropic API key
# or log in via Claude CLI
claude setup-token                     # OAuth (openseed setup will detect it)
```

## Core Commands

```bash
# Search & discover
openseed paper search "diffusion models" --count 20
openseed agent search "multi-agent systems"         # deeper search with trend summary
openseed agent pipeline "ViT image classification"  # search → select → analyze → save

# Manage your library
openseed paper add https://arxiv.org/abs/1706.03762
openseed paper list
openseed paper show <id>

# Analyze papers
openseed agent summarize <id>          # English summary
openseed agent summarize <id> --cn     # Chinese summary
openseed agent review <id>             # peer review
openseed agent ask "What is RLHF?"     # research Q&A
openseed agent codegen <id>            # generate experiment code
```

## License

MIT
