Metadata-Version: 2.4
Name: subconscious-chat
Version: 0.1.7
Summary: A distributed, agentic AI platform — run AI agents everywhere, on every device.
Author-email: Brian Branch <b.branch@ancilla.company>
License: Proprietary
Project-URL: Homepage, https://subconscious.chat
Project-URL: Repository, https://github.com/Ancilla-Company/Subconscious
Project-URL: Bug Tracker, https://github.com/Ancilla-Company/Subconscious/issues
Project-URL: Changelog, https://github.com/Ancilla-Company/Subconscious/blob/master/CHANGELOG.md
Keywords: ai,agent,llm,chat,local-first,multi-platform,ollama,openai,anthropic
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: End Users/Desktop
Classifier: Intended Audience :: Developers
Classifier: License :: Other/Proprietary License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Communications :: Chat
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENCE
Requires-Dist: httpx
Requires-Dist: bcrypt
Requires-Dist: pyyaml
Requires-Dist: fastapi
Requires-Dist: keyring
Requires-Dist: pydantic-ai; sys_platform != "android" and sys_platform != "ios"
Requires-Dist: pydantic-ai-slim; sys_platform != "android" and sys_platform != "ios"
Requires-Dist: pydantic; sys_platform != "android" and sys_platform != "ios"
Requires-Dist: pydantic-graph; sys_platform != "android" and sys_platform != "ios"
Requires-Dist: genai-prices; sys_platform != "android" and sys_platform != "ios"
Requires-Dist: griffe; sys_platform != "android" and sys_platform != "ios"
Requires-Dist: opentelemetry-api; sys_platform != "android" and sys_platform != "ios"
Requires-Dist: typing-inspection; sys_platform != "android" and sys_platform != "ios"
Requires-Dist: flet[all]==0.84.0
Requires-Dist: aiosqlite; sys_platform != "android" and sys_platform != "ios"
Requires-Dist: sqlalchemy; sys_platform != "android" and sys_platform != "ios"
Requires-Dist: bs4
Requires-Dist: pypdf
Requires-Dist: openpyxl
Requires-Dist: python-docx
Requires-Dist: desktop-notifier; sys_platform != "android" and sys_platform != "ios"
Requires-Dist: pystray; sys_platform != "android" and sys_platform != "ios"
Requires-Dist: pyperclip; sys_platform != "android" and sys_platform != "ios"
Requires-Dist: send2trash; sys_platform != "android" and sys_platform != "ios"
Requires-Dist: speedtest-cli; sys_platform != "android" and sys_platform != "ios"
Provides-Extra: test
Requires-Dist: pytest; extra == "test"
Requires-Dist: pytest-asyncio; extra == "test"
Dynamic: license-file

# Subconscious — Your Distributed AI Agent

<div align="center">
  <img alt="Subconscious Logo" src="https://raw.githubusercontent.com/Ancilla-Company/Subconscious/master/docs/white_banner.png" width="100%" />
</div>

<p align="center">
  <em>A distributed, agentic AI platform that allows you to create AI agents running everywhere, on all your connected devices.</em><br>
  <b>An open-source alternative to ChatGPT, Claude & Grok; A packaged alternative to Open Claw & Open WebUI</b>
</p>

<p align="center">
  <a href="https://github.com/Ancilla-Company/Subconscious/actions/workflows/release.yaml">
    <img src="https://github.com/Ancilla-Company/Subconscious/actions/workflows/release.yaml/badge.svg" alt="Build and Release">
  </a>
  <a href="https://github.com/Ancilla-Company/Subconscious/stargazers">
    <img src="https://img.shields.io/github/stars/Ancilla-Company/Subconscious?style=flat&color=yellow" alt="GitHub Stars">
  </a>
  <a href="https://pypi.org/project/subconscious-chat/">
    <img src="https://img.shields.io/pypi/v/subconscious-chat?color=blue" alt="PyPI Version">
  </a>
  <a href="https://subconscious.chat/docs">
    <img src="https://img.shields.io/badge/docs-subconscious.chat-brightgreen.svg" alt="Documentation">
  </a>
</p>

<div align="center">
  <img alt="Subconscious UI Demo" src="https://raw.githubusercontent.com/Ancilla-Company/Subconscious/master/docs/thread.png" width="80%">
</div>

## ✨ Key Features

- **🔒 Local-First Architecture**: Your data is exclusively yours. All chats, logs, and settings are stored locally.
- **🖥️ Run Local Models**: Execute models completely offline using powerful local servers like **Ollama**.
- **🔑 Bring Your Own Keys (BYOK)**: Use your own API keys to connect to the models of your choice.
- **🛠️ Built-in Tools Out-of-the-Box**: Outfitted with numerous handy local tools. Just ask your Subconscious what it can do! Manage access natively inside settings. Currently supports: `Terminal`, `FileSystem`, `Calculator`, `Clipboard`, `Contacts`, `Time`, `Weather`, `Web Tools`, and more!
- **📱 True Multi-Platform Support**: Works beautifully via Python and Windows executables out-of-the-box.
- **🔄 Auto-Updates**: Subconscious automatically checks for the latest features, with a convenient one-button seamless update.
- **🧵 Agentic Threads**: Create varied threads/chats/agents for distinct purposes; fine-tune context effortlessly.
- **📁 Workspaces**: Keep organized. Compartmentalize your threads by workspace for related themes, such as 'Work', 'Personal', or a special side-project.
- **⏱️ To-Dos & Scheduled Tasks**: Delegate routine chores. Let your agent maintain a to-do list or schedule tasks for exact execution times.

<div align="center">
  <img alt="Sidebar & Workspaces Screenshot" src="https://raw.githubusercontent.com/Ancilla-Company/Subconscious/master/docs/workspaces.png" width="80%">
</div>

---

## 🚀 Getting Started Flow

Subconscious is designed to be as ubiquitous as you are. Use your phone to execute a process on your VPS, or operate Subconscious in your terminal while browsing.

### Installation (Recommended)

#### Microsoft Windows (via Winget)

The fastest way to install the Subconscious Desktop App natively on Windows:

```shell
winget install Ancilla.Subconscious-Chat

```

#### Via Python Pip

For Mac, Linux, and Windows users comfortable with Python:

Create and activate a new Python environment (e.g., using `venv` or `conda`), then install via PyPI:

```shell
pip install -U subconscious-chat

```

_Note: If using pip, you will need Python 3.12 or newer._

### 🛠️ From Source (Development)

Love tinkering? Getting Subconscious running locally via source is easy.

```shell
git clone https://github.com/Ancilla-Company/Subconscious.git
cd Subconscious

# Alternatively, use the included VS Code Task "Pip Install Editable"

pip install -e .

```

<div align="center">
  <img alt="Settings & Model Configuration Screenshot" src="https://raw.githubusercontent.com/Ancilla-Company/Subconscious/master/docs/settings.png" width="80%">
</div>

---

## Supported Models

With our native integration to the best APIs and local servers, Subconscious flexibly connects to:

- **OpenAI** (GPT-4o, etc)
- **Anthropic** (Claude 3.5 Sonnet/Opus, etc)
- **Google GenAI** (Gemini)
- **Ollama** (Llama-3, Phi, Mistral — 100% Offline)
- **DeepSeek**
- **Mistral**
- **Groq**
- **Grok**
- **Hugging Face**

---

## Running Subconscious

### Desktop App

If you installed the Winget package or built the binary via Nuikta/PyInstaller, simply launch **Subconscious** from your Start menu / App launcher!

### CLI / Python

Once installed via pip, start the agent directly:

```shell
subconscious

```

---

## 🗺️ Roadmap & Highlights

We are shipping fast. Here is a glimpse of what's currently being integrated:
- **Swarm Access**: Start on one device and continue from another. Begin a task in your browser and seamlessly transition to your phone.
- **Agentic Threads**: Create varied threads/chats/agents for distinct purposes. Assign specific tools and fine-tune context effortlessly.
- **True Multi-Platform Support**: Web, Linux, MacOS, Browser, Android and iOS are actively coming soon!
- **Custom & External Tools**: Built in Python natively, meaning extending Subconscious with your own tools is a breeze. Connect to external APIs or services to supercharge your workflow.
- **More Models Coming Soon**: We are actively working on expanding support for as many models as possible.
- **Voice Input Button**: Speak directly to Subconscious with accompanying outputs/animations.
- **Computer Interaction Tools**: Allow the AI to control mouse/keyboard using computer usage agent protocols.
- **Directory RAG System**: Instantly query your local filesystem docs.
- **Mini Mode / Always-On-Top**: Perfect for persistent UI integration while researching.
- **MCP Server Connections**: Next-gen integrations for extended memory and actions.

## 🤝 Contributions

Subconscious is open source and community-driven! We welcome bug reports, pull requests, and ideas. Please check out the issues tab or submit a PR for a feature from the roadmap.

## 📜 License

This project is open-source and available to the community under a custom license based on BSD-3-Clause with additional branding restrictions.

### Third-Party Components

Subconscious bundles various third-party libraries. See `THIRD_PARTY_LICENSES.txt` for a complete list of bundled components and their licenses.

### LGPL Components

Subconscious includes LGPL-licensed components (notably `pystray` for system tray functionality). In compliance with LGPL requirements:

- The source code for LGPL components is available at their respective upstream repositories
- Users may modify and update these components independently
- For questions about LGPL compliance, please contact the maintainers

### Enterprise Licensing

For commercial/enterprise use beyond the open-source license terms, please contact the maintainers for enterprise licensing options.
