Update README and documentation with author, repository, and donation information

parent f32637ee
Pipeline #218 canceled with stages
...@@ -4,6 +4,14 @@ ...@@ -4,6 +4,14 @@
AISBF is a modular proxy server for managing multiple AI provider integrations. It provides a unified API interface for interacting with various AI services (Google, OpenAI, Anthropic, Ollama) with support for provider rotation and error tracking. AISBF is a modular proxy server for managing multiple AI provider integrations. It provides a unified API interface for interacting with various AI services (Google, OpenAI, Anthropic, Ollama) with support for provider rotation and error tracking.
## Author
Stefy Lanza <stefy@nexlab.net>
## Repository
Official repository: https://git.nexlab.net/nexlab/aisbf.git
## Project Structure ## Project Structure
``` ```
......
# AI Proxy Server # AISBF - AI Service Broker Framework || AI Should Be Free
A unified proxy server for multiple AI providers with proper type handlers and library integration. A modular proxy server for managing multiple AI provider integrations with unified API interface.
## Architecture ## Author
The proxy is organized into multiple modules for better maintainability: Stefy Lanza <stefy@nexlab.net>
- `main.py` - Entry point and FastAPI application setup ## Repository
- `config.py` - Configuration management and provider loading
- `models.py` - Pydantic models for data structures
- `providers.py` - Provider type handlers with proper library integration
- `handlers.py` - Request/response handling logic
## Supported Providers Official repository: https://git.nexlab.net/nexlab/aisbf.git
The proxy supports multiple AI providers with proper type handlers:
- **Google** - Uses `google-genai` library
- **OpenAI** - Uses `openai` library
- **Anthropic** - Uses `anthropic` library
- **Ollama** - Uses direct HTTP requests
## Installation ## Quick Start
### Installation
```bash ```bash
pip install -r requirements.txt python setup.py install
``` ```
## Usage ### Usage
Start the proxy server:
```bash ```bash
./start_proxy.sh aisbf
```
The server will start on `http://localhost:8000`
## API Endpoints
### Chat Completions
```http
POST /api/{provider_id}/chat/completions
``` ```
**Request Body:** Server starts on `http://localhost:8000`
```json
{
"model": "model_name",
"messages": [
{"role": "user", "content": "Hello!"}
],
"max_tokens": 100,
"temperature": 0.7,
"stream": false
}
```
### List Models
```http ## Supported Providers
GET /api/{provider_id}/models - Google (google-genai)
``` - OpenAI and openai-compatible endpoints (openai)
- Anthropic (anthropic)
- Ollama (direct HTTP)
## Configuration ## Configuration
See `config/providers.json` and `config/rotations.json` for configuration examples.
Providers are configured in `providers.json` with proper type definitions: ## API Endpoints
- `GET /` - Server status and provider list
```json - `POST /api/{provider_id}/chat/completions` - Chat completions
{ - `GET /api/{provider_id}/models` - List available models
"providers": {
"openai": {
"id": "openai",
"name": "OpenAI",
"endpoint": "https://api.openai.com/v1",
"type": "openai",
"api_key_required": true
}
}
}
```
## Error Handling ## Error Handling
The proxy includes robust error handling with:
- Rate limiting for failed requests - Rate limiting for failed requests
- Automatic retry with provider rotation - Automatic retry with provider rotation
- Proper error tracking and logging - Proper error tracking and logging
## Donations ## Donations
The project includes multiple donation options to support its development:
The extension includes multiple donation options to support its development:
### Web3/MetaMask Donation ### Web3/MetaMask Donation
Works on any website - The Web3 donation is completely independent of the current page Works on any website - The Web3 donation is completely independent of the current page
...@@ -110,3 +62,9 @@ Always available regardless of browser setup ...@@ -110,3 +62,9 @@ Always available regardless of browser setup
### Bitcoin Donation ### Bitcoin Donation
Address: bc1qcpt2uutqkz4456j5r78rjm3gwq03h5fpwmcc5u Address: bc1qcpt2uutqkz4456j5r78rjm3gwq03h5fpwmcc5u
Traditional BTC donation method Traditional BTC donation method
## Documentation
See `DOCUMENTATION.md` for complete API documentation, configuration details, and development guides.
## License
GNU General Public License v3.0
\ No newline at end of file
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment