finch-cli 0.1.1__py3-none-any.whl

finch_cli-0.1.1.dist-info/METADATA

@@ -0,0 +1,140 @@
+Metadata-Version: 2.4
+Name: finch-cli
+Version: 0.1.1
+Summary: Tailor your resume to any job posting from your terminal.
+Project-URL: Homepage, https://applyfinch.com
+Project-URL: Repository, https://github.com/applyEasy/finch-cli
+Project-URL: Issues, https://github.com/applyEasy/finch-cli/issues
+Author-email: Carlos Luna-Pena <carlunpen@gmail.com>
+License: MIT
+License-File: LICENSE
+Keywords: ai,career,cli,deepseek,internship,job-search,openai,resume,textual,tui
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Requires-Dist: click>=8.1.0
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: openai>=1.30.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: textual>=0.83.0
+Requires-Dist: trafilatura>=1.12.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Requires-Dist: ruff>=0.5; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# finch-cli
+
+a terminal client for job hunting. browse fresh internship + new-grad postings, tailor your resume to any of them, see an ats-style match score with matched + missing keywords, keep a library of the tailored versions.
+
+![jobs tab](docs/tui-jobs.svg)
+
+![tailor tab with match panel](docs/tui-tailor.svg)
+
+## install
+
+```
+pip install finch-cli
+export DEEPSEEK_API_KEY=sk-...
+finch ui
+```
+
+deepseek keys are cheap (currently around $0.27 / 1M input tokens, ~30x cheaper than claude). get one at https://platform.deepseek.com/api_keys.
+
+other providers work too. any openai-compatible chat-completions endpoint: openai, together, groq, fireworks. pass `--base-url` and the matching `--api-key`, or set `FINCH_BASE_URL` and `OPENAI_API_KEY`. the same `finch_cli/tailor.py` runs against all of them.
+
+## what it does
+
+three tabs, one keyboard.
+
+**jobs** pulls the simplifyjobs internship and new-grad lists (the same two feeds the finch backend mirrors). 3000+ active postings, filterable by query, source, term. press T on a row, the job loads into the tailor tab pre-filled.
+
+**library** is the list of tailored resumes you've saved. Markdown preview on the right.
+
+**tailor** is the three-pane editor: base resume / job posting / tailored output. claude rewrites bullets and ordering to fit the posting. won't invent skills you don't have. a match-analysis panel at the bottom shows an ats-style score, which job keywords your resume covers, which ones it doesn't, and how much the tailored version moved the needle vs the base.
+
+## install (pure cli, no tui)
+
+```
+finch tailor --resume resume.md --job https://jobs.example.com/swe-intern -o tailored.md
+```
+
+if the job site is js-heavy (workday, some greenhouse iframes), the fetch fails clean and tells you to use `--job-file` with a pasted description:
+
+```
+finch tailor -r resume.md --job-file pasted.txt -o tailored.md
+```
+
+## tui keys
+
+| key | action |
+|---|---|
+| `1` / `2` / `3` | jump to jobs / library / tailor |
+| `Ctrl+T` | tailor; on jobs tab loads the selected job first |
+| `Ctrl+U` | paste a job url, fetches it into the tailor pane |
+| `Ctrl+O` | open a resume file |
+| `Ctrl+R` | refetch the job feeds |
+| `Ctrl+L` | save the tailored output to the library |
+| `Ctrl+S` | save the tailored output to a file |
+| `Ctrl+D` | load the bundled demo |
+| `Ctrl+Q` | quit |
+
+filter inputs at the top of the jobs tab are live; type and the table updates.
+
+## cli flags
+
+`finch tailor`
+
+| flag | what |
+|---|---|
+| `-r, --resume PATH` | base resume in markdown or plain text (required) |
+| `-j, --job URL` | job posting url |
+| `--job-file PATH` | local file with the job description (use if `--job` won't extract) |
+| `-o, --out PATH` | save tailored resume here, else stdout |
+| `--model NAME` | model name (default `deepseek-chat`) |
+| `--api-key KEY` | override `$DEEPSEEK_API_KEY` / `$FINCH_API_KEY` / `$OPENAI_API_KEY` |
+| `--base-url URL` | override openai-compatible base url (default `https://api.deepseek.com`) |
+
+`finch ui`
+
+| flag | what |
+|---|---|
+| `--demo` | preload the bundled example into the tailor tab |
+| `--model NAME` | model name |
+
+## where stuff lives
+
+| | path |
+|---|---|
+| job feed cache (~6h ttl) | `~/.cache/finch-cli/{intern,newgrad}.json` |
+| saved tailored resumes | `~/.local/share/finch-cli/resumes/` |
+| bundled example resume + job | `examples/` in the repo |
+
+## why a cli
+
+most of these tools are saas you have to sign up for. this is the opposite. install, run, the only thing leaving your machine is the llm call you control.
+
+the autofill side - the part that actually fills out the application form - lives in the web app at applyfinch.com, free during beta.
+
+## known limits
+
+- workday and some greenhouse iframe pages need js. the fetch fails clean and tells you to use `--job-file`.
+- tailored output is markdown. pipe to pandoc for pdf, or paste into overleaf if you have a tex template.
+- the model won't invent skills. if the base resume is thin, the tailored version is thin. fix the base first.
+
+## roadmap
+
+- a built-in pdf renderer (drop the pandoc step)
+- `finch apply` to autofill the application after tailoring, same engine as the web app
+- optional sign-in to view your real applyfinch.com pipeline from the terminal
+
+## license
+
+mit.

finch_cli-0.1.1.dist-info/RECORD

@@ -0,0 +1,17 @@
+finch_cli/__init__.py,sha256=E-x2HVj5IgHjl7rO8-rwK4I2acfakiBACbl2yOFAahQ,99
+finch_cli/__main__.py,sha256=MSmt_5Xg84uHqzTN38JwgseJK8rsJn_11A8WD99VtEo,61
+finch_cli/cli.py,sha256=-ajh5D-zAjaWedxxO2i6nt57q4J2paSEPiX5-aNB4Yg,4490
+finch_cli/fetch.py,sha256=2CgVHR2X-IYLSOwDbjjUJX-pUmnSnaQkec4WMoz5KU8,4663
+finch_cli/jobs.py,sha256=qyb7ws7VylQASFN46M8vDCqZLCyHqc6RtdiWmrYAZDc,5236
+finch_cli/output.py,sha256=43SjShhWQH2Z6oy9-8Mh01GBGf4oFWQ5log3SUEv4qM,531
+finch_cli/score.py,sha256=PyGsdBrVlh2pbaOiJFb-3bVkI1CLPQ1k7Nf4w1Ax5Uk,7305
+finch_cli/storage.py,sha256=1wVd2rwb7AY3Je8Mukl7wxsrRhpOfCXzWsKrqhYpkF4,2093
+finch_cli/tailor.py,sha256=NjYENE2HXsoWto7Nzx0PbcFBvUih6qeoVLXjNzFAH74,5250
+finch_cli/tui.py,sha256=LqIL-oO0do3Yr5qQIow_OARd0E8qXW4q0L_OXWfiO3E,31199
+finch_cli/_data/base_resume.md,sha256=A2GF5jAARdOMC5sFXcftnFalUd-SL1qohjp18wr3-HU,1332
+finch_cli/_data/job_post.txt,sha256=X_77NokuMNic8uksLb7BuRVBDa5WKwqphewe_gAOZXM,1488
+finch_cli-0.1.1.dist-info/METADATA,sha256=Q8d4J73d76wOQgHsOiwcHmrVdZ8v0yWn6JUmYD43ORM,5491
+finch_cli-0.1.1.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+finch_cli-0.1.1.dist-info/entry_points.txt,sha256=Jn4gSrMQg7KLH6iYWbEQcVLb40Lcl1I-_T361pEf9jk,45
+finch_cli-0.1.1.dist-info/licenses/LICENSE,sha256=2Uiebzp_T4KjsLIPoTKBYa5wfITaCR-Bo5BND05DH14,1073
+finch_cli-0.1.1.dist-info/RECORD,,

finch_cli-0.1.1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any

finch_cli-0.1.1.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+finch = finch_cli.cli:main

finch_cli-0.1.1.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Carlos Luna-Pena
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.