{"id":44317312,"url":"https://github.com/basher83/radiant-filament","last_synced_at":"2026-02-11T05:15:07.151Z","repository":{"id":328928345,"uuid":"1116092496","full_name":"basher83/radiant-filament","owner":"basher83","description":null,"archived":false,"fork":false,"pushed_at":"2026-01-18T20:48:23.000Z","size":153,"stargazers_count":0,"open_issues_count":4,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-19T04:00:40.956Z","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":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/basher83.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"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-12-14T07:14:47.000Z","updated_at":"2025-12-20T11:00:35.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/basher83/radiant-filament","commit_stats":null,"previous_names":["basher83/radiant-filament"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/basher83/radiant-filament","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/basher83%2Fradiant-filament","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/basher83%2Fradiant-filament/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/basher83%2Fradiant-filament/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/basher83%2Fradiant-filament/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/basher83","download_url":"https://codeload.github.com/basher83/radiant-filament/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/basher83%2Fradiant-filament/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29327156,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-11T03:52:29.695Z","status":"ssl_error","status_checked_at":"2026-02-11T03:52:23.094Z","response_time":97,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":"2026-02-11T05:15:07.093Z","updated_at":"2026-02-11T05:15:07.142Z","avatar_url":"https://github.com/basher83.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Radiant Filament\n\nRadiant Filament is a robust CLI tool designed to interface with Google's Gemini Deep Research capabilities. It\nprovides a streaming, resilient, and visually rich terminal interface for conducting deep, agentic research sessions.\n\n## Prerequisites\n\n- **Python 3.13+**\n- **[uv](https://docs.astral.sh/uv/)** for dependency management\n- A **Google Gemini API Key** set as an environment variable:\n\n  ```bash\n  export GEMINI_API_KEY=\"your-api-key-here\"\n  ```\n\n## Quick Start (No Installation)\n\nRun directly from GitHub using `uvx`:\n\n```bash\nuvx --from git+https://github.com/basher83/radiant-filament radiant-filament \"Your research prompt\"\n```\n\n## Installation\n\n1. Clone the repository:\n\n   ```bash\n   git clone https://github.com/basher83/radiant-filament.git\n   cd radiant-filament\n   ```\n\n2. Install dependencies:\n\n   ```bash\n   uv sync\n   ```\n\n## Usage\n\nRun the researcher from the CLI:\n\n```bash\nuv run radiant-filament \"Your research prompt here\"\n```\n\n### CLI Options\n\n| Option | Description |\n|--------|-------------|\n| `--prompt-file PATH` | Path to a file containing the research prompt |\n| `--output PATH` | Save the research report to a file |\n| `--agent-name NAME` | Agent version to use (default: `deep-research-pro-preview-12-2025`) |\n| `--previous-interaction-id ID` | Continue from a completed interaction for follow-up questions |\n| `--model NAME` | Use a model instead of agent for follow-ups (requires `--previous-interaction-id`) |\n| `--file-search STORE` | File search store name (can be repeated for multiple stores) |\n| `--agent-config JSON` | Agent config as JSON string or path to JSON file |\n| `--no-stream` | Use polling mode instead of streaming |\n\n### Examples\n\nBasic research:\n\n```bash\nuv run radiant-filament \"Research the history of quantum computing\"\n```\n\nSave output to file:\n\n```bash\nuv run radiant-filament \"Investigate the history of fusion energy\" --output report.md\n```\n\nResearch using a prompt file:\n\n```bash\nuv run radiant-filament --prompt-file docs/prompts/my-research.md --output report.md\n```\n\nSpecify a custom agent version:\n\n```bash\nuv run radiant-filament \"Deep dive into quantum computing\" --agent-name \"deep-research-pro-preview-12-2025\"\n```\n\nUse polling instead of streaming:\n\n```bash\nuv run radiant-filament \"Research topic\" --no-stream\n```\n\nFollow-up on previous research (the interaction ID is printed after each research session):\n\n```bash\nuv run radiant-filament \"Elaborate on point 2\" --previous-interaction-id \u003cid\u003e\n```\n\nQuick follow-up with a model (no deep research, faster response):\n\n```bash\nuv run radiant-filament \"Summarize in 3 bullets\" --previous-interaction-id \u003cid\u003e --model gemini-2.5-pro\n```\n\nResearch with file search (use your uploaded file stores):\n\n```bash\nuv run radiant-filament \"Analyze our Q1 report\" --file-search fileSearchStores/my-store\n```\n\nCustom agent configuration:\n\n```bash\nuv run radiant-filament \"Research topic\" --agent-config '{\"thinking_summaries\": \"none\"}'\n```\n\nOr load config from a file:\n\n```bash\nuv run radiant-filament \"Research topic\" --agent-config config.json\n```\n\nView help:\n\n```bash\nuv run radiant-filament --help\n```\n\n## Features\n\n- **Deep Research**: Leverages Gemini's advanced agentic capabilities to explore complex topics with multi-step\n  reasoning.\n- **Follow-up Questions**: Continue conversations with previous research sessions using interaction IDs, or use a\n  standard model for quick follow-ups.\n- **File Search Integration**: Connect to Gemini file search stores to research your own uploaded documents.\n- **Streaming \u0026 Polling Modes**: Watch results stream in real-time, or use polling mode for more stable connections.\n- **Resilient Connection**: Built-in automatic reconnection with exponential backoff (2s to 60s) ensures long-running\n  research sessions aren't lost due to transient network issues.\n- **Rich Terminal UI**: Features real-time Markdown rendering, status spinners, and live thought summaries using\n  [Rich](https://github.com/Textualize/rich).\n- **Configurable Agent**: Customize agent behavior via JSON config (inline or file-based).\n\n## Development\n\nRun tests:\n\n```bash\nuv run pytest\n```\n\nLint and format:\n\n```bash\nuv run ruff check .\nuv run ruff format .\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbasher83%2Fradiant-filament","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbasher83%2Fradiant-filament","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbasher83%2Fradiant-filament/lists"}