# asta-paper-finder: A Frozen-in-Time Agent for Reproducing Paper Finder Evaluations

This repository profile is provided by osrepos.com, an open source repository discovery platform.

Source: osrepos.com
Repository profile: https://osrepos.com/repo/allenai-asta-paper-finder
Generated for open source discovery and AI-assisted research.

asta-paper-finder is a standalone, "frozen-in-time" version of the AllenAI Paper Finder agent. This repository provides the code specifically for reproducing evaluation results, allowing researchers to locate sets of papers based on content and metadata criteria. It offers a stable snapshot of the agent's core paper-finding capabilities.

GitHub: https://github.com/allenai/asta-paper-finder
OSRepos URL: https://osrepos.com/repo/allenai-asta-paper-finder

## Summary

asta-paper-finder is a standalone, "frozen-in-time" version of the AllenAI Paper Finder agent. This repository provides the code specifically for reproducing evaluation results, allowing researchers to locate sets of papers based on content and metadata criteria. It offers a stable snapshot of the agent's core paper-finding capabilities.

## Topics

- Python
- AI
- LLM
- Research Tools
- Natural Language Processing
- Information Retrieval
- Academic Search
- Reproducibility

## Repository Information

Last analyzed by OSRepos: Fri Apr 24 2026 17:38:25 GMT+0100 (Western European Summer Time)
Detail views: 0
GitHub clicks: 2

## Safety Notice

OSRepos shares public repositories for knowledge and discovery only. Review source code, dependencies, licenses, and security implications before running or installing anything.

## Content

## Introduction
The `asta-paper-finder` repository hosts a standalone, "frozen-in-time" version of the AllenAI Paper Finder agent. This specific release is designed for reproducing evaluation results, offering a stable and consistent environment to assess the agent's performance. PaperFinder is an intelligent agent built to assist users in locating relevant academic papers by analyzing content-based and metadata criteria through a pipeline of manual-coded components and LLM decisions. While this version focuses on core single-turn paper search functionality, it provides a clear insight into the agent's underlying logic and capabilities, distinct from the actively maintained live version.

## Installation
To set up and run the `asta-paper-finder` agent, follow these steps:

### Secrets File
The agent requires several API keys. Create a `.env.secret` file within `agents/mabool/api/conf` and define the following keys:
- `OPENAI_API_KEY`
- `S2_API_KEY`
- `COHERE_API_KEY`
- `GOOGLE_API_KEY`

### Environment
The project uses `uv` for dependency management. Prepare your environment by running:
bash
make sync-dev


### Running the Agent
Navigate to the API directory and start the FastAPI server:
bash
cd agents/mabool/api
make start-dev

Once the server is running, you can interact with it via cURL or the Swagger web interface.

## Examples
The agent exposes a POST API endpoint `/api/2/rounds` for paper searching. Here's how to use it:

The API accepts a JSON payload with the following arguments:

{
  "paper_description": "string",
  "operation_mode": "infer",
  "inserted_before": "string",
  "read_results_from_cache": false
}

- `paper_description` (REQUIRED): A natural language description of the papers you are searching for.
- `operation_mode` (default="infer"): Specifies the search intensity. Options are "infer", "fast", or "diligent". "infer" and "fast" perform a quick search (approx. 30 seconds), while "diligent" conducts a more exhaustive search (approx. 3 minutes).
- `inserted_before` (default=None): An optional upper-bound date in YYYY-MM-DD format to limit results to papers published before this date.
- `read_results_from_cache` (default=False): If set to `true`, the agent will attempt to return results from a disk-based cache if available.

## Why Use asta-paper-finder?
`asta-paper-finder` is invaluable for researchers and developers interested in the core mechanics of an LLM-powered paper-finding agent. Its "frozen-in-time" nature ensures stability and consistency, making it ideal for:
- **Reproducibility**: Accurately reproduce and verify evaluation results reported for the Paper Finder agent.
- **Understanding Core Logic**: Study the pipeline of components, LLM decisions, and relevance judgments without the complexities of a live, evolving product.
- **Benchmarking**: Use a stable version for comparative analysis and developing new benchmarks for paper-seeking agents.
This repository offers a focused view on the single-turn paper search functionality, stripped of multi-turn interaction, UI, and production environment integrations, providing a clean slate for academic and experimental purposes.

## Links
- **GitHub Repository**: [https://github.com/allenai/asta-paper-finder](https://github.com/allenai/asta-paper-finder){:target="_blank"}
- **Live PaperFinder Agent**: [https://paperfinder.allen.ai/](https://paperfinder.allen.ai/){:target="_blank"}