{"id":25689020,"url":"https://github.com/kokofixcomputers/1min-relay","last_synced_at":"2025-07-11T07:35:58.534Z","repository":{"id":273790382,"uuid":"920891990","full_name":"kokofixcomputers/1min-relay","owner":"kokofixcomputers","description":"This project is a relay from 1min ai api to openai like structure","archived":false,"fork":false,"pushed_at":"2025-06-09T16:19:58.000Z","size":137,"stargazers_count":30,"open_issues_count":5,"forks_count":9,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-06-09T17:25:36.217Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kokofixcomputers.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":"kokofixcomputers","custom":"https://donate.stripe.com/00w4gB1NbdI60afcKPgMw00"}},"created_at":"2025-01-23T00:26:11.000Z","updated_at":"2025-06-09T17:23:31.000Z","dependencies_parsed_at":"2025-04-24T01:41:42.918Z","dependency_job_id":"30cba7fb-8fc5-497b-9a50-98645b72ca48","html_url":"https://github.com/kokofixcomputers/1min-relay","commit_stats":null,"previous_names":["kokofixcomputers/1min_relay","kokofixcomputers/1min-relay"],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/kokofixcomputers/1min-relay","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kokofixcomputers%2F1min-relay","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kokofixcomputers%2F1min-relay/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kokofixcomputers%2F1min-relay/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kokofixcomputers%2F1min-relay/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kokofixcomputers","download_url":"https://codeload.github.com/kokofixcomputers/1min-relay/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kokofixcomputers%2F1min-relay/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264756765,"owners_count":23659309,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-02-24T21:17:28.274Z","updated_at":"2025-07-11T07:35:58.529Z","avatar_url":"https://github.com/kokofixcomputers.png","language":"Python","funding_links":["https://github.com/sponsors/kokofixcomputers","https://donate.stripe.com/00w4gB1NbdI60afcKPgMw00"],"categories":[],"sub_categories":[],"readme":"# 1min-Relay\nRelay 1min AI API to OpenAI Structure in 1 minute.\n\nDon't forget to star this repository if you like it! \n\nOh and by the way, join our discord server for support and updates!\n[https://discord.gg/GQd3DrxXyj](https://discord.gg/GQd3DrxXyj)\n\nPlease support us by donating at https://donate.stripe.com/00w4gB1NbdI60afcKPgMw00 or purchasing the paid version (hosted) at https://shop.kokodev.cc/product/7 AND, by purchasing the paid version, you get many perks too! Check below for perks!\n\n## Features\n- **bolt.diy Support**: Compatible with bolt.diy for seamless integration.\n- **Conversation History**: Retain and manage conversation history effortlessly.\n- **Broad Client Compatibility**: Works with most clients supporting OpenAI Custom Endpoint.\n- **Fast and Reliable Relay**: Relays 1min AI API to OpenAI-compatible structure within 1 minute.\n- **User-Friendly**: Easy to set up and quick to use.\n- **Model Exposure Control**: Expose all or a predefined subset of 1min.ai-supported models.\n- **Streaming Support**: Enables real-time streaming for faster interactions.\n- **Non-Streaming Support**: Compatible with non-streaming workflows.\n- **Docker Support**: Deploy easily with Docker for fast and consistent setup.\n- **Multi-Document Support**: Supports document uploads for enhanced functionality. Some include .docx, .pdf, .txt, .yaml and etc.\n- **Image Support**: Supports image uploads for enhanced functionality.\n- **ARM64 and AMD64 Support**: Compatible with both ARM64 and AMD64 architectures.\n- **Multiple Requests**: Supports multiple requests simultaneously.\n\n## Paid Perks\n- **Hosted**: Hosted for you, accessible anytime, anywhere.\n- **Latest Features**: Get access to latest features such as image generations that are not yet available in the public version.\n- **Priority Bug Fix**: Get the most common bug fixed quickly\n- **Priority Support**: Get support quicker than public version!\n\n\n## Installation:\n\nClone the git repo into your machine with:\n```bash\ngit clone https://github.com/kokofixcomputers/1min-relay.git\n```\n\n### Bare-metal\n\nTo install dependencies, run:\n```bash\npip install -r requirements.txt\n```\n\nand then run python3 main.py\n\nDepending on your system, you may need to run `python` instead of `python3`.\n\n### Docker\nRunning 1min-relay in docker is the easiet method. Please note that the connection ip address displayed on server start will be wrong when in docker.\n\n#### Pre-Built images\n\n1. Pull the Docker Image:\n```bash\ndocker pull kokofixcomputers/1min-relay:latest\n```\n\n2. To encrease security, 1min-relay will require it's own network to be able to communicate with memcached.\nTo create a network, run:\n```bash\ndocker network create 1min-relay-network\n```\n\n3. Run Memcached.\n```bash\ndocker run -d --name memcached --network 1min-relay-network memcached\n```\n\n4. Run the 1min-relay Container:\n```bash\ndocker run -d --name 1min-relay-container --network 1min-relay-network -p 5001:5001 \\\n  -e SUBSET_OF_ONE_MIN_PERMITTED_MODELS=\"mistral-nemo,gpt-4o-mini,deepseek-chat\" \\\n  -e PERMIT_MODELS_FROM_SUBSET_ONLY=True \\\n  kokofixcomputers/1min-relay:latest\n```\nEnvironment Variables:\n\n- `SUBSET_OF_ONE_MIN_PERMITTED_MODELS`: Specifies a subset of 1min.ai models to expose. Default: mistral-nemo,gpt-4o,deepseek-chat.\n- `PERMIT_MODELS_FROM_SUBSET_ONLY`: Restricts model usage to the specified subset. Set to True to enforce this restriction or False to allow all models supported by 1min.ai. Default: True.\n\n\n#### Self-Build\n\n1. Build the Docker Image\nFrom the project directory (where Dockerfile and main.py reside), run:\n\n```bash\ndocker build -t 1min-relay:latest .\n```\n\n2. To encrease security, 1min-relay will require it's own network to be able to communicate with memcached.\nTo create a network, run:\n```bash\ndocker network create 1min-relay-network\n```\n\n3. Run Memcached.\n```bash\ndocker run -d --name memcached --network 1min-relay-network memcached\n```\n\n4. Run the 1min-relay Container:\n```bash\ndocker run -d --name 1min-relay-container --network 1min-relay-network -p 5001:5001 \\\n  -e SUBSET_OF_ONE_MIN_PERMITTED_MODELS=\"mistral-nemo,gpt-4o-mini,deepseek-chat\" \\\n  -e PERMIT_MODELS_FROM_SUBSET_ONLY=True \\\n  1min-relay:latest\n```\n\n- `-d` runs the container in detached (background) mode.\n- `-p 5001:5001` maps your host’s port 5001 to the container’s port 5001.\n- `--name 1min-relay-container` is optional, but it makes it easier to stop or remove the container later.\n- `-e`: Specifies environment variables.\n- `SUBSET_OF_ONE_MIN_PERMITTED_MODELS`: Specifies a subset of 1min.ai models to expose. Default: mistral-nemo,gpt-4o,deepseek-chat.\n- `PERMIT_MODELS_FROM_SUBSET_ONLY`: Restricts model usage to the specified subset. Set to True to enforce this restriction or False to allow all models supported by 1min.ai. Default: False.\n\n\n4. Verify It’s Running\nCheck logs (optional):\n\n```bash\ndocker logs -f 1min-relay-container\n```\nYou should see your Flask server output: “Server is ready to serve at …”\n\nTest from your host machine:\n\n```bash\ncurl -X GET http://localhost:5001/v1/models\n```\n\n5. Stopping or Removing the Container\nTo stop the container:\n\n```bash\ndocker stop 1min-relay-container\n```\n\nTo remove the container:\n\n```bash\ndocker rm 1min-relay-container\n```\n\nTo remove the image entirely:\n\n```bash\ndocker rmi 1min-relay:latest\n```\n\nOptional: Run with Docker Compose\nIf you prefer Docker Compose, you can run the docker compose included with the repo:\n\nJust run:\n\n```bash\ndocker compose up -d\n```\nCompose will automatically do these things for you:\n- Create a network\n- Run Memcached\n- Run the 1min-relay Container\n\n#### Managing docker containers\nYou can also have multiple instances of 1min-relay running on the same machine with docker.\n\nYou just need to chznge the name parameter of the container so you can identify them.\n\nTo stop a 1min-relay container, run:\n```bash\ndocker stop 1min-relay-container\n```\nTo start it again, run:\n```bash\ndocker start 1min-relay-container\n```\n\n### Environment Variables\n- `SUBSET_OF_ONE_MIN_PERMITTED_MODELS`: Specifies a subset of 1min.ai models to expose. Default: mistral-nemo,gpt-4o,deepseek-chat.\n- `PERMIT_MODELS_FROM_SUBSET_ONLY`: Restricts model usage to the specified subset. Set to True to enforce this restriction or False to allow all models supported by 1min.ai. Default: False.\n\n### Support\nPlease consider supporting us by donating at https://donate.stripe.com/00w4gB1NbdI60afcKPgMw00 or contributing.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkokofixcomputers%2F1min-relay","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkokofixcomputers%2F1min-relay","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkokofixcomputers%2F1min-relay/lists"}