The Adapters package facilitates communication between different language model APIs by providing a unified interface for interaction. This ensures ease of use and flexibility in integrating multiple models from various providers.

The package can be installed an used via pip:

pip install martian-adapters

• Python version: 3.11.6
• Poetry

poetry install
poetry run pre-commit install

Pre-commit hooks help maintain code quality and standards. Install them with the following command:

poetry run pre-commit install

To run pre-commit manually:

poetry run pre-commit run --all-files

For versioning we follow Semantic Versioning

The package requires certain environment variables to be set by the users:

• Copy .env-example to .env and populate it with appropriate values.

Ensure Python 3.11 is used:

poetry run pytest

from adapters import AdapterFactory, Prompt

adapter = AdapterFactory.get_adapter_by_path("openai/openai/gpt-4o-mini")

prompt = Prompt("Who is your favorite Martian?")
conversation = adapter.convert_to_input(prompt)

adapter.execute_sync(conversation)

Adapter paths follows the format provider/vendor/model_name. Use AdapterFactory.get_supported_models() to retrieve all supported models. For a given model, model.get_path() returns the adapter path.

1. Existing Providers: Add new models to the SUPPORTED_MODELS array if the provider is already supported.

2. New Providers:

   • If the provider follows the OpenAI format, model integration is straightforward. See the "Together" provider class as an example.
   • For providers with different schemas, see the "Anthropic" provider class for guidance.

1. Add the Provider and Model: Update provider_adapters/__init__.py and test files accordingly.

2. Write Tests: Add tests in the relevant directories. Use @pytest.mark.vcr for tests making network requests.

3. Run Tests:

   poetry run pytest

4. Check-in Cassette Files: Include any new cassette YAML files in your commit.

5. Send a Pull Request: Ensure all tests pass before requesting a review.

Use the --record-mode=rewrite option with pytest to update cassette files.

Some models may only be accessible from specific locations (e.g., the U.S.). In such cases, running tests might require access to a U.S.-based server.

This documentation provides a streamlined approach to using and contributing to the Adapters package, emphasizing practical steps and clear examples.