Metadata-Version: 2.4
Name: cosmos-ai
Version: 0.2.2
Summary: A full AI chatbot that lives in your terminal. 25+ free models via OpenRouter.
Project-URL: Homepage, https://cosmos-tui.app
Project-URL: Repository, https://github.com/Sharann-del/Cosmos
Author: Sharann Manojkumar
License: MIT
License-File: LICENSE
Keywords: ai,chat,llm,openrouter,terminal,tui
Classifier: Environment :: Console
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Terminals
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27.0
Requires-Dist: pypdf>=4.0.0
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: textual>=0.60.0
Description-Content-Type: text/markdown

<br>

<div align="center">

<div align="center">

<img src="assets/cosmos.svg" alt="Cosmos" width="500">

</div>

### The AI chatbot that lives in your terminal.

Twenty-five frontier models. Streaming responses. Cloud-synced history.
No subscription. No credit card. No config files.

```
pip install cosmos-ai
```

[**Website**](https://cosmos-tui.app) · [**Get Started**](#quickstart) · [**Features**](#features) · [**Models**](#models)

![Python](https://img.shields.io/badge/python-3.10+-blue?style=flat-square)
![PyPI](https://img.shields.io/pypi/v/cosmos-ai?style=flat-square)
![License](https://img.shields.io/badge/license-MIT-green?style=flat-square)
![Built with Textual](https://img.shields.io/badge/built%20with-Textual-5a3fd6?style=flat-square)

</div>



## What is Cosmos?

Cosmos is a fast, keyboard-driven AI chat client that runs entirely in your terminal. It speaks to 25+ free models through [OpenRouter](https://openrouter.ai) — DeepSeek R1, Llama 3.3, Gemini 2.0 Flash, and more — and renders their answers as live-streaming Markdown, syntax-highlighted code, tables, and charts, all inside a clean monochrome TUI.

No browser tab. No mouse. No `.env` files to babysit. You log in once, and your models, history, and folders follow you to every machine you touch.

![Cosmos demo](assets/demo.gif)



## Quickstart

**1. Install**

```bash
pip install cosmos-ai
```

**2. Sign up** at [cosmos-tui.app](https://cosmos-tui.app)

Enter your name and your [OpenRouter API key](https://openrouter.ai/keys). That's it — your key is stored securely in your account, so there's nothing to configure locally.

**3. Launch**

```bash
cosmos
```

Log in once, and you're talking to frontier models in under a minute. Your key, history, and folders sync from the cloud automatically.

> **Why an account instead of a config file?** Because your setup should work on your laptop, your work machine, and that SSH session into a box you'll never see again — without copying secrets around. Sign in, and Cosmos pulls everything down.



## Features

### 25+ free models, switchable mid-conversation
Start a thread on Gemini 2.0 Flash for speed, hit `/models`, and finish it on DeepSeek R1 for deep reasoning — without losing context. Every model OpenRouter offers for free is one keystroke away.

### Real-time streaming
Tokens render the instant they arrive, with a pulsing `●` indicator so you always know the model is still thinking. No spinners, no waiting for the full response to land.

### Cloud-synced chat history
Every conversation is saved, organized into folders, and synced to your account. Close your laptop, open your desktop, pick up exactly where you left off.

### File attachments
Drop in images, PDFs, DOCX, code files, or plain text and ask questions about them. Cosmos handles the parsing — you handle the curiosity.

### Rich terminal output
Full Markdown rendering with tables, syntax-highlighted code blocks, Mermaid diagrams, and ASCII bar charts. Your terminal has never looked this good.

<img width="1411" height="871" alt="chat" src="https://github.com/user-attachments/assets/9d1fc214-6c5a-4499-baf5-ba87dfb2e4b4" />

## Models

A taste of what's available out of the box, all **completely free** via OpenRouter:

| Model | Best for |
|-|-|
| **DeepSeek R1** | Deep reasoning, math, hard logic |
| **Llama 3.3 70B** | General chat, reliable all-rounder |
| **Gemini 2.0 Flash** | Speed, long context, quick answers |
| **Qwen 2.5** | Code generation, multilingual |
| **Mistral** | Lean, fast, efficient responses |
| **GPT-4o mini** | Balanced quality and latency |

…and 19 more.



## Pricing

Free. All of it.

No subscription, no credit card, no usage caps from us. You bring an OpenRouter API key (also free to create), and you only ever touch the free model tier. Cosmos is the interface; OpenRouter is the engine; your wallet stays closed.



## Built with

- **[Textual](https://textual.textualize.io/)** — the modern Python TUI framework
- **[OpenRouter](https://openrouter.ai)** — unified access to dozens of models
- **Python 3.10+**



## Contributing

Issues, ideas, and pull requests are welcome. Open an issue to start a discussion, or check the [open issues](https://github.com/Sharann-del/Cosmos/issues) for somewhere to jump in.

```bash
git clone https://github.com/Sharann-del/Cosmos.git
cd Cosmos
pip install -e .
```



## License

MIT — see [LICENSE](LICENSE).

