fatcat-scholar / Internet Archive Scholar

This is source code for scholar.archive.org, a full-text web search interface over the 25+ million open research papers in the Internet Archive.

All of the technical heavy lifting of harvesting, crawling, and metadata corrections are handled by the fatcat service; this service is just a bare-bones, read-only search interface. Unlike the basic fatcat.wiki search, this index allows querying the full content of papers when available.

Overview

This repository is fairly small and contains:

• fatcat_scholar/: Python code for web service and indexing pipeline
• fatcat_scholar/templates/: HTML template for web interface
• tests/: Python test files
• proposals/: design documentation and change proposals
• data/: empty directory for indexing pipeline

A data pipeline converts groups of one or more fatcat "release" entities (grouped under a single "work" entity) into a single search index document. Elasticsearch is used as the full-text search engine. A simple web interface parses search requests and formats Elasticsearch results with highlights and first-page thumbnails.

The current Python web framework is FastAPI, though the number of routes is very small and it would be easy to switch to a more conventional framework like Flask.

Getting Started for Developers

You need pipenv and Python 3.8 installed. Most tasks are run using a Makefile; make help will show all options.

Working on the indexing pipeline effectively requires internal access to the Internet Archive cluster and services, though some contributions and bugfixes are probably possible without staff access.

To install dependencies for the first time run:

make dep

then run the tests (to ensure everything is working):

make test

To start the web interface run:

make serve

While developing the web interface, you will almost certainly need an example database running locally. A docker-compose file in extra/docker/ can be used to run Elasticsearch 7.x locally. The make dev-index command will reset the local index with the correct schema mapping, and index any intermediate files in the ./data/ directory. We don't have an out-of-the-box solution for non-IA staff at this step (yet).

After making changes to any user interface strings, the interface translation file (".pot") needs to be updated with make extract-i18n. When these changes are merged to master, the Weblate translation system will be updated automatically.

This repository uses black for code formatting; please run make fmt and make lint for submitting a pull request.

Contributing

Software, copy-editing, translation, and other contributions to this repository are welcome! For content and metadata corrections, or identifying new content to include, the best place to start is the in fatcat repository. Learn more in the fatcat guide. You can chat and ask questions on gitter.im/internetarchive/fatcat.

Contributors in this project are asked to abide by our Code of Conduct.

The web interface is translated using the Weblate platform, at internetarchive/fatcat-scholar

The software license for this repository is Affero General Public License v3+ (APGL 3+), as described in the LICENSE.md file. We ask that you acknowledge the license terms when making your first contribution.

For software developers, the "help wanted" tag in Github Issues is a way to discover bugs and tasks that external folks could contribute to.