1. Create a virtual environment and activate it by running:

python3 -m venv .venv
source .venv/bin/activate

2. Install packages

uv sync

This project uses Elasticsearch through Docker Compose to facilitate document indexing and searching.

• Docker and Docker Compose installed on your system
• Curl (optional, to verify Elasticsearch status)

To start the Elasticsearch service, run the following command from the project root:

docker-compose up -d

The -d parameter runs the containers in the background.

To check that Elasticsearch is working properly:

curl http://localhost:9200

You should receive a JSON response with information about the Elasticsearch instance.

To stop the services:

docker-compose down

If you also want to remove the volumes (this will delete all indexed data):

docker-compose down -v

Once Elasticsearch is running, you can run the indexing script:

python index_docs.py

To search for documents, run the following command:

python search_docs.py "Apple total net sales" --top-k 3