hiresquire 1.1.2

HireSquire LangChain Tools - AI-powered candidate screening for agents

HireSquire Python SDK

LangChain tools for HireSquire's AI-powered candidate screening API.

Installation

pip install hiresquire

Quick Start

from hiresquire import create_screening_job, get_screening_status, get_screening_results

# Submit a screening job
result = create_screening_job(
    title="Senior Python Developer",
    description="Looking for experienced Python developer with Django experience...",
    resumes=[
        {"filename": "john_doe.pdf", "content": "John Doe\n5 years Python experience..."}
    ]
)
job_id = result["job_id"]

# Poll for completion
status = get_screening_status(job_id=job_id)
while status["status"] == "processing":
    time.sleep(3)
    status = get_screening_status(job_id=job_id)

# Get results
results = get_screening_results(job_id=job_id)
for candidate in results["candidates"]:
    print(f"{candidate['name']}: {candidate['score']}/100")

Environment Variables

Set these before using the SDK:

export HIRESQUIRE_API_TOKEN="your_api_token_here"
export HIRESQUIRE_BASE_URL="https://api.hiresquireai.com/api/v1"  # optional

LangChain Integration

from langchain.agents import AgentExecutor, create_openai_functions_agent
from langchain_openai import ChatOpenAI
from hiresquire import get_hiresquire_tools

llm = ChatOpenAI(temperature=0)
tools = get_hiresquire_tools()

agent = create_openai_functions_agent(llm, tools)
executor = AgentExecutor(agent=agent, tools=tools, verbose=True)

# Use in an agent
result = executor.invoke({
    "input": "Submit a screening job for a Python developer and find candidates with score > 80"
})

Available Tools

Tool	Description
create_screening_job	Submit a new screening job
get_screening_status	Check job status
get_screening_results	Get completed job results
wait_for_screening_completion	Poll until job completes
generate_candidate_email	Generate outreach email
get_candidates_by_score	Filter candidates by score

API Documentation

Full API documentation available at: https://docs.hiresquireai.com

License

MIT License - see LICENSE file for details.