Build From Source#
This section shows how to build the Semantic Search Agent from source code. Use this path when you need to modify the code or package customized builds.
Prerequisites#
Docker Engine 24 or higher, with the Docker Compose tool v2.
Clone the repository and navigate to the
microservices/semantic-search-agent/directory:git clone https://github.com/open-edge-platform/edge-ai-libraries.git cd edge-ai-libraries/microservices/semantic-search-agent
Verify that the system requirements are met.
Build the Docker Image#
The repository provides the docker/Dockerfile and docker/docker-compose.yml files. The Compose configuration builds the image from local source files.
To build using the Makefile from the microservices/semantic-search-agent/ directory:
make docker-build
To build the image directly using the docker CLI, run the command from the same directory. The build context is . and must be this directory:
docker build \
--build-arg HTTP_PROXY=${HTTP_PROXY} \
--build-arg HTTPS_PROXY=${HTTPS_PROXY} \
-t intel/semantic-search-agent:2026.3.0-rc1 \
-f docker/Dockerfile \
.
After the build completes, verify that the image exists with docker images intel/semantic-search-agent.
This packages the application code, installs Python dependencies, and configures the container to run as a non-root user with User Identifier (UID) 1000.
Note
If you are behind a corporate proxy, pass --build-arg HTTP_PROXY and --build-arg HTTPS_PROXY as shown above so pip can reach the PyPI repository during the build.
Build a Python Environment (Standalone)#
To set up a local development environment and run or test the service directly:
# Create and activate python venv
python -m venv venv
source venv/bin/activate
# Install dependencies
pip install --upgrade pip
pip install -r requirements.txt
Verify the Build#
To test the build locally, run the automated test suite:
# Run tests with coverage report
make test
# Or run tests directly with pytest
pytest
To run a faster test pass without coverage:
make test-fast
If all tests pass, the build is functional and ready for deployment.