A Go plugin for Firebase GenKit that provides seamless integration with VolcEngine's models. This plugin enables developers to leverage advanced AI capabilities including text generation, streaming responses, tool calling, and multimodal support.

• 🚀 Text Generation: Support for various Doubao and DeepSeek models
• 📡 Streaming Support: Real-time response streaming for better user experience
• 🛠️ Tool Calling: Function calling capabilities for complex AI workflows
• 🎯 Multimodal Support: Handle text, images, audio, and video inputs
• ⚡ High Performance: Optimized for production workloads
• 🔧 Easy Configuration: Multiple initialization methods for different use cases

• Go 1.24.1 or higher
• VolcEngine API Key (Get one here)

go get github.com/ipfans/genkit-plugin-volcengine

import (
    "github.com/firebase/genkit/go/genkit"
    volcengine "github.com/ipfans/genkit-plugin-volcengine"
)

    // Initialize GenKit with VolcEngine plugin
    genkit.Init(
        ctx,
        genkit.WithPlugins(
            volcengine.VolcEngineWithAPIKey(
                os.Getenv("VOLCENGINE_API_KEY"),
            ),
        ),
    )

Set your VolcEngine API key:

export VOLCENGINE_API_KEY="your_volcengine_api_key_here"

Or create a .env file:

echo "VOLCENGINE_API_KEY=your_volcengine_api_key_here" > .env

• ✅ Multiturn Conversations: All models support conversation history
• ✅ Tool Calling: Function calling for external integrations
• ✅ System Messages: Custom system prompts for behavior control
• ✅ Streaming: Real-time response generation
• ✅ Multimodal: Image, audio, and video support (Doubao models only)

volcengine.VolcEngineWithAPIKey("your_api_key")

volcengine.VolcEngineWithClient(client)

# Clone the repository
git clone https://github.com/ipfans/genkit-plugin-volcengine.git
cd genkit-plugin-volcengine

# Build the module
go build

# Run tests
go test ./...

# Update dependencies
go mod tidy

# Format code
go fmt ./...

# Vet code
go vet ./...

# Static analysis
golangci-lint run

Check out the example directory for a complete working example that demonstrates:

• Basic setup and configuration
• Model selection and usage
• Development server setup
• Task automation with Taskfile

API Key Not Set

Error: VOLCENGINE_API_KEY environment variable is not set
Solution: Set the environment variable or pass the key during initialization

We welcome contributions! Please see our Contributing Guide for details.

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests for new functionality
5. Ensure all tests pass
6. Submit a pull request

Please use the GitHub Issues page to report bugs or request features.

This project is licensed under the MIT License. See the LICENSE file for details.

• Firebase GenKit Documentation
• VolcEngine Developer Console
• VolcEngine API Documentation
• Example Project