Skip to content

[Platform] add Albert API support #140

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Jul 17, 2025
Merged

Conversation

chr-hertel
Copy link
Member

Q A
Bug fix? no
New feature? yes
Docs? yes
Issues
License MIT

Cherry picking php-llm/llm-chain#366

@chr-hertel chr-hertel added the Platform Issues & PRs about the AI Platform component label Jul 16, 2025
This PR adds support for [Albert
API](https://github.com/etalab-ia/albert-api), the French government's
sovereign AI gateway. Albert provides an OpenAI-compatible API interface
for various language models while ensuring data sovereignty and
compliance with French/EU regulations.

- 🇫🇷 **Sovereign AI**: Albert is hosted and operated by the French
government
- 🔧 **OpenAI-compatible**: Uses the same API structure as OpenAI
- 🔒 **Data Privacy**: Ensures data remains within French/EU jurisdiction
- 🎯 **Public Sector Focus**: Designed for use by French public
administration

- Created Albert-specific model clients (GPTModelClient and
EmbeddingsModelClient) with configurable base URL
- Added PlatformFactory for easy Albert API initialization
- Reuses OpenAI's response converters for compatibility
- Supports both chat completions and embeddings endpoints

```php
use PhpLlm\LlmChain\Platform\Bridge\Albert\PlatformFactory;
use PhpLlm\LlmChain\Platform\Bridge\OpenAI\GPT;

$platform = PlatformFactory::create(
    apiKey: $_ENV['ALBERT_API_KEY'],
    albertUrl: $_ENV['ALBERT_API_URL']
);

$model = new GPT('gpt-4o');
$chain = new Chain($platform, $model);
```

- Added unit tests for PlatformFactory
- Added example script demonstrating Albert API usage with RAG context
- All tests pass and code follows project standards

- Updated README to list Albert as a supported platform
- Added example file showing how to use Albert API
- Included context about French AI strategy in the example

This implementation allows French public sector organizations to
leverage LLM Chain while maintaining data sovereignty and regulatory
compliance.

Closes #346
@chr-hertel chr-hertel force-pushed the feat/albert-api-support branch from d7020ed to 99ce42a Compare July 16, 2025 21:31
@chr-hertel chr-hertel changed the title feat: add Albert API support [Platform] add Albert API support Jul 16, 2025
@OskarStark
Copy link
Contributor

Changelog can be found here:

@chr-hertel
Copy link
Member Author

Thank you @OskarStark.

@chr-hertel chr-hertel merged commit 88826f8 into main Jul 17, 2025
26 checks passed
chr-hertel added a commit that referenced this pull request Jul 17, 2025
This PR was merged into the main branch.

Discussion
----------

[Platform] Add Albert API to platform CHANGELOG

## Summary
- Added Albert API to the platform CHANGELOG as it was missing from PR #140

This PR adds the changelog entry for the Albert API support that was merged in #140. The Albert API is a French sovereign AI gateway that provides OpenAI-compatible endpoints while ensuring data remains within French/EU jurisdiction.

## References
- Original PR: #140

Commits
-------

eb88a4c Add Albert API support to platform CHANGELOG
@OskarStark
Copy link
Contributor

friendly ping @gundesli

@OskarStark OskarStark deleted the feat/albert-api-support branch July 17, 2025 11:58
@gundesli
Copy link

Very nice, thank you @OskarStark 👍

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Platform Issues & PRs about the AI Platform component
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants