{"id":31785467,"url":"https://github.com/filaforge/filament-huggingface-chat","last_synced_at":"2026-07-03T04:32:21.559Z","repository":{"id":310710877,"uuid":"1040960043","full_name":"filaforge/filament-huggingface-chat","owner":"filaforge","description":"Filament plugin for Hugging Face AI chat integration","archived":false,"fork":false,"pushed_at":"2025-08-20T01:18:11.000Z","size":45,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-10-30T10:46:13.425Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"PHP","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/filaforge.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-08-19T19:07:56.000Z","updated_at":"2025-08-19T21:36:13.000Z","dependencies_parsed_at":"2025-08-19T20:35:05.680Z","dependency_job_id":"769f618c-cd0e-4f1d-9b33-7ee3c59e096b","html_url":"https://github.com/filaforge/filament-huggingface-chat","commit_stats":null,"previous_names":["filaforge/filament-huggingface-chat"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/filaforge/filament-huggingface-chat","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/filaforge%2Ffilament-huggingface-chat","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/filaforge%2Ffilament-huggingface-chat/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/filaforge%2Ffilament-huggingface-chat/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/filaforge%2Ffilament-huggingface-chat/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/filaforge","download_url":"https://codeload.github.com/filaforge/filament-huggingface-chat/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/filaforge%2Ffilament-huggingface-chat/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35072406,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-03T02:00:05.635Z","response_time":110,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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-10-10T11:55:14.918Z","updated_at":"2026-07-03T04:32:21.514Z","avatar_url":"https://github.com/filaforge.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Filaforge HuggingFace Chat\n\nA powerful Filament plugin that integrates HuggingFace AI chat capabilities directly into your admin panel.\n\n## Features\n\n- **HuggingFace AI Integration**: Chat with thousands of AI models from HuggingFace\n- **Conversation Management**: Save, organize, and continue chat conversations\n- **Model Selection**: Choose from a wide variety of AI models\n- **Customizable Settings**: Configure API tokens, models, and chat parameters\n- **Real-time Chat**: Live chat experience with streaming responses\n- **Conversation History**: Keep track of all your AI conversations\n- **Export Conversations**: Save and share chat transcripts\n- **Role-based Access**: Configurable user permissions and access control\n- **Multi-model Support**: Switch between different HuggingFace models\n- **Context Awareness**: Maintain conversation context across sessions\n\n## Installation\n\n### 1. Install via Composer\n\n```bash\ncomposer require filaforge/huggingface-chat\n```\n\n### 2. Publish \u0026 Migrate\n\n```bash\n# Publish provider groups (config, views, migrations)\nphp artisan vendor:publish --provider=\"Filaforge\\\\HuggingfaceChat\\\\Providers\\\\HfChatServiceProvider\"\n\n# Run migrations\nphp artisan migrate\n```\n\n### 3. Register Plugin\n\nAdd the plugin to your Filament panel provider:\n\n```php\nuse Filament\\Panel;\n\npublic function panel(Panel $panel): Panel\n{\n    return $panel\n        // ... other configuration\n        -\u003eplugin(\\Filaforge\\HuggingfaceChat\\Providers\\HfChatPanelPlugin::make());\n}\n```\n\n## Setup\n\n### Configuration\n\nThe plugin will automatically:\n- Publish configuration files to `config/hf-chat.php`\n- Publish view files to `resources/views/vendor/hf-chat/`\n- Publish migration files to `database/migrations/`\n- Register necessary routes and middleware\n\n### HuggingFace API Configuration\n\nConfigure your HuggingFace API in the published config file:\n\n```php\n// config/hf-chat.php\nreturn [\n    'api_token' =\u003e env('HF_API_TOKEN'),\n    'base_url' =\u003e env('HF_BASE_URL', 'https://api-inference.huggingface.co'),\n    'default_model' =\u003e env('HF_MODEL_ID', 'meta-llama/Meta-Llama-3-8B-Instruct'),\n    'max_length' =\u003e env('HF_MAX_LENGTH', 512),\n    'temperature' =\u003e env('HF_TEMPERATURE', 0.7),\n    'stream' =\u003e env('HF_STREAM', false),\n    'timeout' =\u003e env('HF_TIMEOUT', 60),\n    'use_openai_format' =\u003e env('HF_USE_OPENAI', true),\n];\n```\n\n### Environment Variables\n\nAdd these to your `.env` file:\n\n```env\nHF_API_TOKEN=your_huggingface_api_token_here\nHF_BASE_URL=https://api-inference.huggingface.co\nHF_MODEL_ID=meta-llama/Meta-Llama-3-8B-Instruct\nHF_MAX_LENGTH=512\nHF_TEMPERATURE=0.7\nHF_STREAM=false\nHF_TIMEOUT=60\nHF_USE_OPENAI=true\n```\n\n### Getting Your HuggingFace API Token\n\n1. Visit [HuggingFace](https://huggingface.co/)\n2. Create an account or sign in\n3. Go to your profile settings\n4. Navigate to \"Access Tokens\"\n5. Generate a new token\n6. Copy the token to your `.env` file\n\n## Usage\n\n### Accessing HuggingFace Chat\n\n1. Navigate to your Filament admin panel\n2. Look for the \"HF Chat\" menu item\n3. Start chatting with AI models\n\n### Starting a Conversation\n\n1. **Select Model**: Choose from available HuggingFace models\n2. **Type Your Message**: Enter your question or prompt\n3. **Send Message**: Submit your message to the AI\n4. **View Response**: See the AI's response\n5. **Continue Chat**: Keep the conversation going\n\n### Managing Conversations\n\n1. **New Chat**: Start a fresh conversation\n2. **Save Chat**: Automatically save important conversations\n3. **Load Chat**: Resume previous conversations\n4. **Export Chat**: Download conversation transcripts\n5. **Delete Chat**: Remove unwanted conversations\n\n### Advanced Features\n\n- **Model Selection**: Switch between different HuggingFace models\n- **Parameter Tuning**: Adjust temperature, max length, and other settings\n- **Context Management**: Maintain conversation context across sessions\n- **Streaming Responses**: Real-time AI responses (when supported)\n\n## Troubleshooting\n\n### Common Issues\n\n- **API token errors**: Verify your HuggingFace API token is correct\n- **Rate limiting**: Check your HuggingFace API rate limits and usage\n- **Model not available**: Ensure the selected model is available and loaded\n- **Connection timeouts**: Check network connectivity and timeout settings\n\n### Debug Steps\n\n1. Check the plugin configuration:\n```bash\nphp artisan config:show hf-chat\n```\n\n2. Verify routes are registered:\n```bash\nphp artisan route:list | grep hf-chat\n```\n\n3. Test API connectivity:\n```bash\nphp artisan tinker\n# Test your API token manually\n```\n\n4. Check environment variables:\n```bash\nphp artisan tinker\necho env('HF_API_TOKEN');\n```\n\n5. Clear caches:\n```bash\nphp artisan optimize:clear\n```\n\n6. Check logs for errors:\n```bash\ntail -f storage/logs/laravel.log\n```\n\n### API Error Codes\n\n- **401 Unauthorized**: Invalid or expired API token\n- **429 Too Many Requests**: Rate limit exceeded\n- **503 Service Unavailable**: Model is currently loading or unavailable\n- **Timeout**: Request took too long to complete\n\n## Security Considerations\n\n### Access Control\n\n- **Role-based permissions**: Restrict access to authorized users only\n- **API token security**: Never expose API tokens in client-side code\n- **User isolation**: Ensure users can only access their own conversations\n- **Audit logging**: Track all chat activities and API usage\n\n### Best Practices\n\n- Use environment variables for API tokens\n- Implement proper user authentication\n- Monitor API usage and costs\n- Regularly rotate API tokens\n- Set appropriate rate limits\n\n## Uninstall\n\n### 1. Remove Plugin Registration\n\nRemove the plugin from your panel provider:\n```php\n// remove -\u003eplugin(\\Filaforge\\HuggingfaceChat\\Providers\\HfChatPanelPlugin::make())\n```\n\n### 2. Roll Back Migrations (Optional)\n\n```bash\nphp artisan migrate:rollback\n# or roll back specific published files if needed\n```\n\n### 3. Remove Published Assets (Optional)\n\n```bash\nrm -f config/hf-chat.php\nrm -rf resources/views/vendor/hf-chat\n```\n\n### 4. Remove Package and Clear Caches\n\n```bash\ncomposer remove filaforge/huggingface-chat\nphp artisan optimize:clear\n```\n\n### 5. Clean Up Environment Variables\n\nRemove these from your `.env` file:\n```env\nHF_API_TOKEN=your_huggingface_api_token_here\nHF_BASE_URL=https://api-inference.huggingface.co\nHF_MODEL_ID=meta-llama/Meta-Llama-3-8B-Instruct\nHF_MAX_LENGTH=512\nHF_TEMPERATURE=0.7\nHF_STREAM=false\nHF_TIMEOUT=60\nHF_USE_OPENAI=true\n```\n\n## Support\n\n- **Documentation**: [GitHub Repository](https://github.com/filaforge/huggingface-chat)\n- **Issues**: [GitHub Issues](https://github.com/filaforge/huggingface-chat/issues)\n- **Discussions**: [GitHub Discussions](https://github.com/filaforge/huggingface-chat/discussions)\n\n## Contributing\n\nWe welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.\n\n## License\n\nThis plugin is open-sourced software licensed under the [MIT license](LICENSE).\n\n---\n\n**Made with ❤️ by the Filaforge Team**\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffilaforge%2Ffilament-huggingface-chat","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffilaforge%2Ffilament-huggingface-chat","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffilaforge%2Ffilament-huggingface-chat/lists"}