hirekit 0.1.0__tar.gz

hirekit-0.1.0/.env.example

@@ -0,0 +1,12 @@
+# HireKit API Keys
+# Get your DART API key at: https://opendart.fss.or.kr/
+DART_API_KEY=
+
+# Naver Search API (optional)
+# Get keys at: https://developers.naver.com/
+NAVER_CLIENT_ID=
+NAVER_CLIENT_SECRET=
+
+# LLM API Keys (optional — HireKit works without these)
+# OPENAI_API_KEY=
+# ANTHROPIC_API_KEY=

hirekit-0.1.0/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,25 @@
+---
+name: Bug Report
+about: Report a bug to help us improve
+title: "[Bug] "
+labels: bug
+---
+
+**Describe the bug**
+A clear description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce:
+1. Run `hirekit ...`
+2. See error
+
+**Expected behavior**
+What you expected to happen.
+
+**Environment:**
+- OS: [e.g., macOS, Ubuntu]
+- Python version: [e.g., 3.11]
+- HireKit version: [e.g., 0.1.0]
+
+**Additional context**
+Any other context about the problem.

hirekit-0.1.0/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,18 @@
+---
+name: Feature Request
+about: Suggest a new feature or data source
+title: "[Feature] "
+labels: enhancement
+---
+
+**Is your feature request related to a problem?**
+A clear description of the problem.
+
+**Describe the solution you'd like**
+What you want to happen.
+
+**Data source plugin?**
+If this is a new data source, which region (kr/us/global) and what data does it provide?
+
+**Additional context**
+Any other context or screenshots.

hirekit-0.1.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,17 @@
+## Summary
+
+Brief description of changes.
+
+## Type
+
+- [ ] Bug fix
+- [ ] New feature
+- [ ] New data source plugin
+- [ ] Documentation
+- [ ] Refactoring
+
+## Checklist
+
+- [ ] Tests added/updated
+- [ ] Linting passes (`ruff check`)
+- [ ] Documentation updated (if needed)

hirekit-0.1.0/.gitignore

@@ -0,0 +1,18 @@
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+dist/
+build/
+.eggs/
+.venv/
+venv/
+*.egg
+.mypy_cache/
+.pytest_cache/
+.ruff_cache/
+*.db
+reports/
+.env
+.omc/
+.github/workflows/

hirekit-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,53 @@
+# Contributing to HireKit
+
+Thank you for your interest in contributing! Here's how to get started.
+
+## Development Setup
+
+```bash
+# Clone the repo
+git clone https://github.com/ziho/hirekit.git
+cd hirekit
+
+# Create virtual environment
+python3 -m venv .venv
+source .venv/bin/activate
+
+# Install in development mode
+pip install -e ".[dev]"
+
+# Run tests
+pytest
+
+# Run linter
+ruff check src/ tests/
+```
+
+## Adding a Data Source Plugin
+
+1. Create a new file in `src/hirekit/sources/{region}/`
+2. Implement the `BaseSource` protocol
+3. Register with `@SourceRegistry.register`
+4. Add entry point in `pyproject.toml`
+5. Write tests in `tests/test_sources/`
+
+See `src/hirekit/sources/base.py` for the full protocol documentation.
+
+## Code Style
+
+- We use `ruff` for linting and formatting
+- Type hints are required for all public functions
+- Tests are required for new features
+
+## Pull Request Process
+
+1. Fork the repo and create your branch from `main`
+2. Add tests for any new functionality
+3. Ensure all tests pass (`pytest`)
+4. Ensure linting passes (`ruff check`)
+5. Update documentation if needed
+6. Submit a PR with a clear description
+
+## Reporting Issues
+
+Use GitHub Issues with the provided templates (bug report or feature request).

hirekit-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ziho
+
+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.

hirekit-0.1.0/PKG-INFO

@@ -0,0 +1,332 @@
+Metadata-Version: 2.4
+Name: hirekit
+Version: 0.1.0
+Summary: AI-powered company analysis and interview preparation CLI for job seekers
+Project-URL: Homepage, https://github.com/ziho/hirekit
+Project-URL: Documentation, https://github.com/ziho/hirekit/docs
+Project-URL: Repository, https://github.com/ziho/hirekit
+Project-URL: Issues, https://github.com/ziho/hirekit/issues
+Author: ziho
+License: MIT
+License-File: LICENSE
+Keywords: ai,career,company-analysis,dart,interview-prep,job-search
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Office/Business
+Requires-Python: >=3.11
+Requires-Dist: beautifulsoup4>=4.12
+Requires-Dist: httpx>=0.25
+Requires-Dist: jinja2>=3.1
+Requires-Dist: lxml>=5.0
+Requires-Dist: pydantic>=2.0
+Requires-Dist: python-dotenv>=1.0
+Requires-Dist: rich>=13.0
+Requires-Dist: typer>=0.9
+Provides-Extra: all
+Requires-Dist: litellm>=1.0; extra == 'all'
+Requires-Dist: notion-client>=2.0; extra == 'all'
+Requires-Dist: pykrx>=1.0; extra == 'all'
+Provides-Extra: anthropic
+Requires-Dist: anthropic>=0.20; extra == 'anthropic'
+Provides-Extra: dev
+Requires-Dist: mypy>=1.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Requires-Dist: respx>=0.20; extra == 'dev'
+Requires-Dist: ruff>=0.1; extra == 'dev'
+Provides-Extra: kr
+Requires-Dist: pykrx>=1.0; extra == 'kr'
+Provides-Extra: llm
+Requires-Dist: litellm>=1.0; extra == 'llm'
+Provides-Extra: notion
+Requires-Dist: notion-client>=2.0; extra == 'notion'
+Provides-Extra: ollama
+Requires-Dist: ollama>=0.1; extra == 'ollama'
+Provides-Extra: openai
+Requires-Dist: openai>=1.0; extra == 'openai'
+Description-Content-Type: text/markdown
+
+<p align="center">
+  <h1 align="center">HireKit</h1>
+  <p align="center">
+    <strong>AI-powered company analysis and interview preparation CLI for job seekers</strong>
+  </p>
+  <p align="center">
+    Research companies. Match jobs. Ace interviews.
+  </p>
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/hirekit/"><img src="https://img.shields.io/pypi/v/hirekit" alt="PyPI"></a>
+  <a href="https://github.com/zihoshin-dev/hirekit/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License"></a>
+  <a href="https://www.python.org/downloads/"><img src="https://img.shields.io/badge/python-3.11+-blue.svg" alt="Python"></a>
+  <a href="https://github.com/zihoshin-dev/hirekit"><img src="https://img.shields.io/github/stars/zihoshin-dev/hirekit?style=social" alt="Stars"></a>
+</p>
+
+---
+
+## Why It Matters
+
+You're in an interview. Your interviewer asks: **"Why do you want to work here?"**
+
+You pause. You didn't research the company beyond the job posting.
+
+**90% of rejected candidates cite "unprepared" as feedback.**
+
+Meanwhile, company research takes **4-8 hours** across fragmented sources:
+- DART filings (Korean finance jargon, hard to parse)
+- News articles (biased, scattered across 10+ sites)
+- Glassdoor reviews (complaint-focused, outdated)
+- GitHub (tech only, no culture insights)
+- LinkedIn, internal wikis, salary data
+
+No tool combines these into one actionable intelligence report.
+
+**HireKit solves this:** One command, 2 minutes, 8 data sources, 1 decision-ready report.
+
+---
+
+## How It Works
+
+```bash
+# Step 1: Install (30 seconds)
+$ pip install hirekit
+
+# Step 2: Configure API keys (1 minute, one-time)
+$ hirekit configure
+> DART API Key: [paste]
+> Naver Client ID: [paste]
+
+# Step 3: Analyze a company (2 minutes)
+$ hirekit analyze 카카오
+
+# Output: 12-section decision report
+```
+
+**Total time: 3 minutes vs. 4-8 hours of manual research**
+
+---
+
+## What You Get
+
+**Single Actionable Score: 0-100 Job Fit Rating**
+
+```
+82/100 = Strong Opportunity (Go for it)
+75/100 = Competitive (Worth applying with prep)
+60/100 = Caution (Red flags exist — investigate)
+```
+
+**12-Section Report covering:**
+- Executive summary with key reasons
+- Financial health (salary negotiation potential)
+- Tech stack & interview depth questions
+- Recent news & company trajectory
+- Culture & team dynamics
+- Risk flags & mitigation strategies
+- Interview prep tips specific to this company
+
+**Multi-source cross-validation:**
+- 8+ data sources collected in parallel
+- Conflicts highlighted ("News says growing, DART shows debt spike — investigate")
+- Evidence-based scoring, not gut feeling
+- All sources cited with dates
+
+---
+
+## Quick Start
+
+```bash
+# Install
+pip install hirekit
+
+# Configure (set up API keys)
+hirekit configure
+
+# Analyze a company
+hirekit analyze 카카오
+
+# View available data sources
+hirekit sources
+```
+
+---
+
+## What's Next?
+
+After analyzing a company, you can:
+
+```bash
+# Compare companies side-by-side
+$ hirekit compare 카카오 네이버 --focus salary,growth
+
+# Match your resume to a job posting
+$ hirekit match https://wanted.co.kr/job-123 resume.pdf
+
+# Prepare interview questions specific to this company
+$ hirekit interview 카카오 --role backend-engineer
+
+# Get interview feedback on your resume
+$ hirekit resume review resume.pdf --company 카카오
+```
+
+👉 **[Full Tutorial](docs/tutorial.md)** | **[CLI Reference](docs/cli-reference.md)** | **[FAQ](docs/faq.md)**
+
+---
+
+## Features
+
+- **8-source parallel collection** — DART financials, Google/Naver/Brave/Exa news, Reuters, Korean biz press, GitHub tech scoring, Glassdoor reviews (all collected simultaneously)
+- **12-section structured reports** — Executive summary, financial health, tech stack, news/trajectory, culture, compensation, growth potential, risks, interview prep, scorecard, similar companies, action items
+- **Weighted 5-dimension scorecard** — Job Fit (30%), Career Leverage (20%), Growth Potential (20%), Compensation (15%), Culture Fit (15%) — 100-point decision score, not subjective rating
+- **LLM-optional** — Works without any AI (template mode for offline use), enhanced with OpenAI/Anthropic/Ollama for deeper analysis
+- **Plugin architecture** — Add custom data sources in 20 lines of Python, no core changes needed
+- **Privacy-first** — All data stays local, no external tracking, no cloud uploads
+
+## Quick Start
+
+```bash
+# Install
+pip install hirekit
+
+# Configure (set up API keys)
+hirekit configure
+
+# Analyze a company
+hirekit analyze 카카오
+
+# View available data sources
+hirekit sources
+```
+
+## Demo
+
+```
+$ hirekit analyze 카카오 --no-llm -o terminal
+
+╭──────────────────── HireKit Analysis ────────────────────╮
+│ Analyzing: 카카오                                        │
+│ Region: kr  Tier: 1  LLM: off                            │
+╰──────────────────────────────────────────────────────────╯
+
+                     카카오 Scorecard
+┌─────────────────────┬────────┬────────┬──────────────────┐
+│ Dimension           │ Weight │  Score │ Evidence         │
+├─────────────────────┼────────┼────────┼──────────────────┤
+│ Job Fit             │    30% │  3.5/5 │ Tech stack data  │
+│ Career Leverage     │    20% │  4.6/5 │ 15 data points   │
+│ Growth Potential    │    20% │  4.5/5 │ Financials +     │
+│                     │        │        │ active news      │
+│ Compensation        │    15% │  3.5/5 │ DART salary data │
+│ Culture Fit         │    15% │  4.5/5 │ Reviews + Exa    │
+│ Total               │        │ 82/100 │ Grade S          │
+└─────────────────────┴────────┴────────┴──────────────────┘
+```
+
+> 8 data sources collected 15 results in parallel — DART financials, Google/Naver/Brave/Exa news, Reuters, Korean biz press, GitHub tech scoring, Glassdoor reviews.
+
+## Data Sources
+
+| Source | Region | Data | API Key |
+|--------|--------|------|---------|
+| DART | KR | Financial filings, employee data | `DART_API_KEY` |
+| Naver News | KR | Recent news articles | `NAVER_CLIENT_ID` |
+| Naver Search | KR | Blog, cafe, web (culture/interview) | `NAVER_CLIENT_ID` |
+| GitHub | Global | Tech maturity scoring | gh CLI |
+| Google News | Global | RSS news (no key needed) | - |
+| Credible News | Global | Reuters, Bloomberg, FT, WSJ + Korean biz press | - |
+| Brave Search | Global | Web + news semantic search | `BRAVE_API_KEY` |
+| Exa Search | Global | AI semantic deep search | `EXA_API_KEY` |
+
+### Adding Custom Sources
+
+```python
+from hirekit.sources.base import BaseSource, SourceRegistry, SourceResult
+
+@SourceRegistry.register
+class MySource(BaseSource):
+    name = "my_source"
+    region = "global"
+    sections = ["tech"]
+
+    def is_available(self) -> bool:
+        return True
+
+    def collect(self, company, **kwargs):
+        # Your data collection logic here
+        return [SourceResult(
+            source_name=self.name,
+            section="tech",
+            data={"key": "value"},
+        )]
+```
+
+## Configuration
+
+Config lives in `~/.hirekit/config.toml`:
+
+```toml
+[analysis]
+default_region = "kr"
+cache_ttl_hours = 168  # 7 days
+
+[llm]
+provider = "none"  # openai, anthropic, ollama, none
+model = "gpt-4o-mini"
+
+[sources]
+enabled = ["dart", "github", "naver_news"]
+
+[output]
+format = "markdown"
+directory = "./reports"
+```
+
+## LLM Support
+
+HireKit works without any LLM (template-based reports). For AI-enhanced analysis:
+
+```bash
+# OpenAI
+pip install hirekit[openai]
+# Set OPENAI_API_KEY in ~/.hirekit/.env
+
+# Anthropic
+pip install hirekit[anthropic]
+
+# Local models via Ollama
+pip install hirekit[ollama]
+
+# Or use litellm for 100+ providers
+pip install hirekit[llm]
+```
+
+## Roadmap
+
+- [x] **Phase 1:** DART + GitHub + News analysis, scorecard, Markdown reports
+- [x] **Phase 2:** JD matching (`hirekit match`), interview prep (`hirekit interview`), resume review (`hirekit resume`)
+- [ ] **Phase 3:** US companies (SEC Edgar), web UI, community plugins, PyPI publish
+
+## Contributing
+
+Contributions are welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+**Good first issues:**
+- Add a new data source plugin
+- Improve report templates
+- Add i18n support
+
+## License
+
+MIT License. See [LICENSE](LICENSE) for details.
+
+---
+
+<p align="center">
+  <sub>Built with care for every job seeker out there.</sub>
+</p>