| Name | exa-cli JSON |
| Version |
0.1.0
JSON |
| download |
| home_page | None |
| Summary | Command-line interface for Exa neural search API |
| upload_time | 2025-10-17 21:25:15 |
| maintainer | None |
| docs_url | None |
| author | Fergus Fettes |
| requires_python | >=3.13 |
| license | MIT |
| keywords |
exa
search
cli
neural-search
ai
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# exa-cli
A command-line interface for the [Exa](https://exa.ai) neural search API. Search the web, find similar content, fetch clean page text, and get AI-powered answers with citations.
## Features
- 🔍 **Neural search** with domain filtering and autoprompt optimization
- 🔗 **Find similar pages** using semantic similarity
- 📄 **Batch fetch content** from multiple URLs in one call
- 🤖 **AI answers** with citations for quick research
## Installation
```bash
pip install exa-cli
```
## Setup
Get an API key from [Exa](https://exa.ai) and set it as an environment variable:
```bash
export EXA_API_KEY="your-api-key-here"
```
Or create a `.env` file in your project:
```
EXA_API_KEY=your-api-key-here
```
## Usage
### Search
Search the web using Exa's neural search:
```bash
# Basic search
exa search "best linux window managers"
# Limit results
exa search "rust async programming" --num 5
# Filter by domain
exa search "machine learning tutorials" --include github.com,arxiv.org
# Exclude domains
exa search "python frameworks" --exclude stackoverflow.com
# Disable autoprompt
exa search "exact query" --no-autoprompt
```
### Find Similar Pages
Find pages similar to a given URL:
```bash
exa similar "https://swaywm.org" --num 5
```
### Fetch Page Content
Get clean, readable text from one or more URLs:
```bash
# Single URL
exa contents "https://archlinux.org"
# Multiple URLs (batch fetch)
exa contents "https://archlinux.org" "https://swaywm.org" "https://github.com/linux-surface"
# Without full text
exa contents "https://example.com" --no-text
```
### Get AI Answers
Ask a question and get an AI-generated answer with citations:
```bash
exa answer "what is the linux surface project"
# Include full text from citations
exa answer "how to install arch linux" --text
```
## Command Reference
```bash
exa search <query> # Search the web
exa similar <url> # Find similar pages
exa contents <url> [<url>...] # Fetch page content (supports multiple URLs)
exa answer <question> # Get AI answer with citations
```
### Common Options
- `--num, -n`: Number of results (default: 10)
- `--include`: Comma-separated domains to include
- `--exclude`: Comma-separated domains to exclude
- `--text/--no-text`: Include/exclude full text content
- `--autoprompt/--no-autoprompt`: Enable/disable query optimization
Run `exa --help` or `exa <command> --help` for more details.
## Development
```bash
git clone https://github.com/yourusername/exa-cli.git
cd exa-cli
uv sync
uv run pytest
```
## License
MIT
Raw data
{
"_id": null,
"home_page": null,
"name": "exa-cli",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.13",
"maintainer_email": null,
"keywords": "exa, search, cli, neural-search, ai",
"author": "Fergus Fettes",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/a7/2b/319c5379a22fb028b45a86dc27436d94754db5ac5c8d68948661ad6ae57d/exa_cli-0.1.0.tar.gz",
"platform": null,
"description": "# exa-cli\n\nA command-line interface for the [Exa](https://exa.ai) neural search API. Search the web, find similar content, fetch clean page text, and get AI-powered answers with citations.\n\n## Features\n\n- \ud83d\udd0d **Neural search** with domain filtering and autoprompt optimization\n- \ud83d\udd17 **Find similar pages** using semantic similarity\n- \ud83d\udcc4 **Batch fetch content** from multiple URLs in one call\n- \ud83e\udd16 **AI answers** with citations for quick research\n\n## Installation\n\n```bash\npip install exa-cli\n```\n\n## Setup\n\nGet an API key from [Exa](https://exa.ai) and set it as an environment variable:\n\n```bash\nexport EXA_API_KEY=\"your-api-key-here\"\n```\n\nOr create a `.env` file in your project:\n\n```\nEXA_API_KEY=your-api-key-here\n```\n\n## Usage\n\n### Search\n\nSearch the web using Exa's neural search:\n\n```bash\n# Basic search\nexa search \"best linux window managers\"\n\n# Limit results\nexa search \"rust async programming\" --num 5\n\n# Filter by domain\nexa search \"machine learning tutorials\" --include github.com,arxiv.org\n\n# Exclude domains\nexa search \"python frameworks\" --exclude stackoverflow.com\n\n# Disable autoprompt\nexa search \"exact query\" --no-autoprompt\n```\n\n### Find Similar Pages\n\nFind pages similar to a given URL:\n\n```bash\nexa similar \"https://swaywm.org\" --num 5\n```\n\n### Fetch Page Content\n\nGet clean, readable text from one or more URLs:\n\n```bash\n# Single URL\nexa contents \"https://archlinux.org\"\n\n# Multiple URLs (batch fetch)\nexa contents \"https://archlinux.org\" \"https://swaywm.org\" \"https://github.com/linux-surface\"\n\n# Without full text\nexa contents \"https://example.com\" --no-text\n```\n\n### Get AI Answers\n\nAsk a question and get an AI-generated answer with citations:\n\n```bash\nexa answer \"what is the linux surface project\"\n\n# Include full text from citations\nexa answer \"how to install arch linux\" --text\n```\n\n## Command Reference\n\n```bash\nexa search <query> # Search the web\nexa similar <url> # Find similar pages\nexa contents <url> [<url>...] # Fetch page content (supports multiple URLs)\nexa answer <question> # Get AI answer with citations\n```\n\n### Common Options\n\n- `--num, -n`: Number of results (default: 10)\n- `--include`: Comma-separated domains to include\n- `--exclude`: Comma-separated domains to exclude\n- `--text/--no-text`: Include/exclude full text content\n- `--autoprompt/--no-autoprompt`: Enable/disable query optimization\n\nRun `exa --help` or `exa <command> --help` for more details.\n\n## Development\n\n```bash\ngit clone https://github.com/yourusername/exa-cli.git\ncd exa-cli\nuv sync\nuv run pytest\n```\n\n## License\n\nMIT\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Command-line interface for Exa neural search API",
"version": "0.1.0",
"project_urls": {
"Homepage": "https://github.com/ffettes/exa-cli",
"Repository": "https://github.com/ffettes/exa-cli"
},
"split_keywords": [
"exa",
" search",
" cli",
" neural-search",
" ai"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "1833ec1901f6f7e1f863308e5645845800446f0ceb0399f7272bd3d1ab9ebf9a",
"md5": "80201ce7f5ae83657a519d95ec80fa55",
"sha256": "6d97e02a57a62763a700c0ae8f9f92a50d27c99a8d2100add4c4908f156d11c0"
},
"downloads": -1,
"filename": "exa_cli-0.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "80201ce7f5ae83657a519d95ec80fa55",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.13",
"size": 5228,
"upload_time": "2025-10-17T21:25:13",
"upload_time_iso_8601": "2025-10-17T21:25:13.908322Z",
"url": "https://files.pythonhosted.org/packages/18/33/ec1901f6f7e1f863308e5645845800446f0ceb0399f7272bd3d1ab9ebf9a/exa_cli-0.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "a72b319c5379a22fb028b45a86dc27436d94754db5ac5c8d68948661ad6ae57d",
"md5": "ee6ad7399f875ad2a5297cc2b224606d",
"sha256": "44e4fc32ecd13e4ec9bd9a790249dde88875457bd5398e617314fec4194090ba"
},
"downloads": -1,
"filename": "exa_cli-0.1.0.tar.gz",
"has_sig": false,
"md5_digest": "ee6ad7399f875ad2a5297cc2b224606d",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.13",
"size": 5789,
"upload_time": "2025-10-17T21:25:15",
"upload_time_iso_8601": "2025-10-17T21:25:15.440452Z",
"url": "https://files.pythonhosted.org/packages/a7/2b/319c5379a22fb028b45a86dc27436d94754db5ac5c8d68948661ad6ae57d/exa_cli-0.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-17 21:25:15",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "ffettes",
"github_project": "exa-cli",
"github_not_found": true,
"lcname": "exa-cli"
}
