pdf_gemini
此套件提供了一種簡單的方式,透過 Google Gemini 與 PDF 檔案進行互動和對話。
- 星標
- 3
- 分支
- 3
- 最近推送(UTC)
- 2025年5月28日
- 專案狀態
- 未封存
原始 README
以下為英文專案原文快照,最新內容請造訪 GitHub。
Pdf Gemini Package
This package provides a simple way to interact, chat with pdf files using google gemini and managing uploaded files.
Features
- Upload PDF to gemini
- Prompt PDF ang get generated response with Google Gemini Api
- Lightweight and easy to integrate into any Flutter app.
Installation
Run the command on your command prompt
flutter pub add pdf_gemini
Usage
Step 1: Import the Package
In your Dart file, import the package:
import 'package:pdf_gemini/pdf_gemini.dart';
Step 2: Provide Your API Key
When using the API service, instantiate the service class and pass your API key to it. Here's an example of how to fetch data from an API endpoint:
void main() async {
const geminiApiKey = 'your_api_key_here';
final genaiService = GenaiClient(geminiApiKey: geminiApiKey);
try {
final testFile = File('');
final data = await genaiService.promptDocument(
'file_name',
'pdf',
testFile.readAsBytesSync(),
'Your prompt',
);
print(data.text);
} catch (e) {
print('Error: $e');
}
}
Example Explained:
- Replace
'your_api_key_here'with your actual API key provided by the service you're integrating. - The
promptDocument()method accepts the document and prompt input and returns the generated response as a model (text: text, citations: sources) if successful. - Make sure to handle exceptions in case of a failed request.
Testing
To ensure your package works as expected, you can write tests to mock API responses. Here's a simple test example:
import 'dart:io';
import 'package:flutter_test/flutter_test.dart';
import 'package:pdf_gemini/pdf_gemini.dart';
void main() {
group('PDFChatClient', () {
const geminiApiKey = '';
final genaiService = GenaiClient(geminiApiKey: geminiApiKey);
test('Prompt PDF Test', () async {
// Create a temporary test file
final testFile = File('your_file_path').readAsBytesSync();
try {
await genaiService.promptDocument(
fileName: 'Your file name',
fileType: 'pdf',
fileData: testFile,
prompt: 'your prompt',
model: 'gemini-1.5-flash',
);
} catch (e) {
fail('Failed: $e');
}
});
});
}
Contributing
Contributions are welcome! If you'd like to improve this package, feel free to fork the repository and submit a pull request. Make sure to write tests for any new features.
License
This project is licensed under the BSD 3-clause license - see the LICENSE file for details.
分類
使用的依賴
依賴清單 4 項
- flutter
{"sdk":"flutter"} - dio
^5.7.0 - flutter_test開發依賴
{"sdk":"flutter"} - flutter_lints開發依賴
^5.0.0
如何選擇適合專案的儲存庫?
先依使用情境篩選,再比較專案活躍情況,最後到原始儲存庫確認使用要求。
- 透過儲存庫名稱、作者或描述搜尋,再依技術分類縮小範圍。
- 綜合星標、分支與最近推送比較專案;星標反映社群關注,不保證品質。
- 使用前在 GitHub 確認 README、授權條款與 Issues。
來源與維護
“A repository is the most basic element of GitHub.”
GitHub Docs — About repositories ↗