Metadata-Version: 2.4
Name: maestro-career-studio
Version: 0.10.1
Summary: A local job-application copilot: match scoring, resume tailoring, an MCP server and a Chrome Companion, run with one command.
License-Expression: Apache-2.0
Project-URL: Homepage, https://github.com/seinun-ai/maestro-career-studio
Project-URL: Source, https://github.com/seinun-ai/maestro-career-studio
Project-URL: Changelog, https://github.com/seinun-ai/maestro-career-studio/blob/main/CHANGELOG.md
Project-URL: Issues, https://github.com/seinun-ai/maestro-career-studio/issues
Classifier: Programming Language :: Python :: 3.12
Classifier: Operating System :: OS Independent
Classifier: Environment :: Console
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: NOTICE
License-File: THIRD_PARTY_NOTICES.md
Requires-Dist: fastapi>=0.115
Requires-Dist: uvicorn[standard]>=0.32
Requires-Dist: sqlalchemy>=2.1.1
Requires-Dist: alembic>=1.13
Requires-Dist: pydantic>=2.13.5
Requires-Dist: pydantic-settings>=2.6
Requires-Dist: openai>=1.54
Requires-Dist: anthropic<2,>=1.13
Requires-Dist: jinja2>=3.1
Requires-Dist: typst==0.15.0
Requires-Dist: pyyaml>=6.0
Requires-Dist: fastembed>=0.4
Requires-Dist: pdfplumber>=0.11
Requires-Dist: pypdfium2>=4
Requires-Dist: pillow>=12.3.0
Requires-Dist: python-multipart>=0.0.9
Requires-Dist: httpx>=0.27
Requires-Dist: cryptography>=43
Requires-Dist: mcp<2,>=1.29.1
Requires-Dist: psutil>=7
Requires-Dist: python-dotenv>=1
Requires-Dist: nodejs-wheel-binaries<25,>=24
Provides-Extra: tracing
Requires-Dist: langfuse>=4; extra == "tracing"
Provides-Extra: dev
Requires-Dist: pytest>=9.1.1; extra == "dev"
Requires-Dist: pytest-asyncio>=0.24; extra == "dev"
Requires-Dist: pytest-xdist>=3.6; extra == "dev"
Requires-Dist: httpx>=0.27; extra == "dev"
Requires-Dist: ruff<0.17,>=0.7; extra == "dev"
Requires-Dist: respx>=0.21; extra == "dev"
Requires-Dist: playwright>=1.63.0; extra == "dev"
Provides-Extra: mcp
Dynamic: license-file

# Maestro Career Studio

If your resume folder has a `v2finalcopy(3)` in it, this is for you.

Maestro keeps one record of what you have actually done and builds each tailored resume from it.
Paste a job description, see how well a resume matches (fixed rules, so the same resume and job
always get the same score), tailor it, and render a real PDF. Every application stays tracked
in one place. A Chrome Companion and an MCP server let your browser and your AI agent work from
that same record.

It all runs on your machine, and your data lives in one folder you own. Here, control is the
whole point.

## Install

macOS and Linux (between the two commands, open a new terminal or run `source $HOME/.local/bin/env`):

```sh
curl -LsSf https://astral.sh/uv/install.sh | sh
uv tool install --python 3.12 maestro-career-studio
```

Windows (open a new PowerShell window between the two commands):

```powershell
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
uv tool install --python 3.12 maestro-career-studio
```

If `maestro` is not found afterwards, run `uv tool update-shell` and open a new terminal.

Best effort: on Windows ARM64 the PDF engine (typst) has no ARM64 wheel, so install an x64 Python under
emulation: `uv tool install --python cpython-3.12-windows-x86_64-none maestro-career-studio`. Alpine and
other musl Linux are not supported by the PDF engine's wheels; use a glibc distro or Docker.

## Run

`maestro start`, then open http://localhost:3000. `maestro stop` closes it, `maestro update`
updates it (your data is snapshotted first), and `maestro connect` connects an AI agent.
Coming from the Docker install? Stop it, then `maestro import-docker <your checkout>` copies your
data over once (the Docker install is only read).

## Where your data lives

- macOS: `~/Library/Application Support/Maestro Career Studio`
- Windows: `%APPDATA%\Maestro Career Studio`
- Linux: `$XDG_DATA_HOME/maestro-career-studio` (default `~/.local/share/maestro-career-studio`)

## More

- Source and docs: https://github.com/seinun-ai/maestro-career-studio
- What leaves your machine, and when: https://github.com/seinun-ai/maestro-career-studio/blob/main/PRIVACY.md
