T is an open-source Financial Intelligence Operating System by T Technology Research Lab.

It is designed for market research, paper trading, backtesting, risk analysis, dashboard analytics, and hallucination-resistant research workflows.

Research only. Not financial advice.

T is currently in public alpha development.

The current repo work is being prepared toward:

v0.10.0-alpha

No version above v0.10.0-alpha is planned at this stage.

Current direction:

• Enhanced backtest analytics
• Dashboard analytics view
• Equity curve visualization
• Trade table view
• Research safety panel
• Hallucination-resistant output guard
• Safety policy documentation
• Professional services documentation
• README polish

T provides a research-first framework for:

• Market data analysis
• Volume anomaly scoring
• Alpha-style research scoring
• Paper trading workflows
• Backtesting
• Risk analysis
• Dashboard analytics
• Trade table review
• Equity curve tracking
• Safety-oriented research output
• Documentation for responsible usage

T is not a live money execution system by default. It is intended for analysis, testing, education, and research workflows.

T includes scoring utilities for studying market behavior using:

• Volume anomaly detection
• Alpha-style scoring
• Risk labels
• Research explanations
• Safety-oriented output text

The backtest system supports:

• Starting balance
• Ending balance
• Net PnL
• Win rate
• Profit factor
• Max drawdown
• Total trades
• Average win
• Average loss
• Best trade PnL
• Worst trade PnL
• Average return percentage
• Equity curve tracking

The Streamlit dashboard provides:

• Mission control checks
• Backtest analytics metrics
• Equity curve visualization
• Trade table view
• Raw JSON inspection
• Research safety panel
• Project status summary

T includes a research output guard that helps reduce unsafe or overconfident market language.

The guard is designed to detect and sanitize:

• Profit assurance language
• Direct directional trading instruction
• Unsafe certainty claims
• Unsafe return-assurance language
• Overconfident market prediction language

Clone the repository:

git clone https://github.com/mosin1982/T.git
cd T

Create and activate a virtual environment:

python -m venv .venv

Windows PowerShell:

.venv\Scripts\activate

Linux/macOS:

source .venv/bin/activate

Install dependencies:

python -m pip install --upgrade pip
pip install -r requirements.txt

Run tests:

python -m pytest -q

Run formatting:

python -m black .

Run linting:

python -m ruff check . --fix

Run the dashboard:

python -m streamlit run dashboard/app.py

Run a backtest if your CLI command is available:

python t_cli.py backtest

The dashboard is located at:

dashboard/app.py

Run:

python -m streamlit run dashboard/app.py

Dashboard sections include:

• System overview
• Mission control
• Backtest analytics
• Equity curve
• Trade table
• Research safety panel
• Next repo updates before v0.10.0-alpha

The enhanced backtest report includes:

Backtest results are historical simulations and should be reviewed carefully.

T/
├─ README.md
├─ CHANGELOG.md
├─ CODE_OF_CONDUCT.md
├─ CONTRIBUTING.md
├─ DISCLAIMER.md
├─ DONATE.md
├─ SECURITY.md
├─ SUPPORT.md
├─ backtest/
│  └─ engine.py
├─ dashboard/
│  └─ app.py
├─ data/
├─ docs/
│  ├─ SAFETY_POLICY.md
│  └─ SERVICES.md
├─ modes/
│  └─ scoring.py
├─ quality/
│  ├─ __init__.py
│  └─ hallucination_guard.py
├─ reports/
├─ tests/
└─ t_cli.py

T is designed as research-only software.

The project should be positioned as:

• Research software
• Educational tooling
• Backtesting infrastructure
• Paper-trading support
• Financial intelligence research system

The project should not be positioned as:

• A wealth-generation product
• A return-assurance product
• A direct trading instruction service
• A portfolio management service
• A replacement for licensed professionals

Read the full policy:

docs/SAFETY_POLICY.md

T is designed as a research-only public alpha system with clear support boundaries, deployment guidance, and a safety-first UI/UX direction.

Important documents:

• Support T
• Support Scope
• Deployment Guide
• UI/UX Design System

Deployment support is technical guidance only. T does not provide financial advice, investment advice, trade recommendations, broker account operation, or managed financial services.

Research only. Not financial advice.

The T source code may be available publicly for research and development use.

T Technology Research Lab may provide paid services for:

• Setup and installation
• Training and walkthrough
• Dashboard customization
• Data integration
• Strategy module configuration
• Business workflow integration
• Deployment support
• Monthly technical support
• Enterprise R&D customization

Suggested service ranges:

Read more:

docs/SERVICES.md

If this project helps your research, learning, testing, or development workflow, you can support the project through donations or paid professional services.

Donations are voluntary and do not create any investment relationship, trading promise, profit assurance, advisory relationship, or service obligation.

For setup, training, dashboard customization, business integration, or enterprise R&D work, use a paid professional service engagement instead of donation.

T is English-first today, with planned global documentation and dashboard language support for wider international users.

Planned human-language direction includes:

• English as the primary global technical language
• Hindi and Hinglish for community support
• Spanish, Arabic, French, Portuguese, Indonesian, and other languages as future documentation options

T is also Python-first today, with future developer-language extension layers planned for Go, Rust, TypeScript, and WebAssembly.

Important documents:

• Global Language Support
• Multi-Language Architecture

Research only. Not financial advice.

---

## Development Workflow

Recommended workflow:

```bash
git checkout main
git pull origin main
git checkout -b feature/your-feature-name

Run quality checks:

python -m black .
python -m ruff check . --fix
python -m pytest -q

Commit:

git add .
git commit -m "Describe the repo update"
git push --set-upstream origin feature/your-feature-name

Then open a pull request on GitHub.

Current rule:

Do not go above v0.10.0-alpha at this stage.

Before any release:

• All tests must pass
• CI must be green
• Dashboard should run locally
• README should be updated
• Safety policy should be present
• Services documentation should be present
• Release notes should be clear

No release should be created from a broken branch, failed CI run, or unresolved merge state.

The repository uses GitHub Actions for quality checks.

Typical checks include:

• Black format check
• Ruff lint check
• Pytest test suite
• Smoke workflow
• Docker build workflow
• Release workflow

Local commands:

python -m black .
python -m ruff check . --fix
python -m pytest -q

Security issues should be handled responsibly.

Read:

SECURITY.md

Contributions should follow the project safety position and research-only direction.

Read:

CONTRIBUTING.md

For support options, read:

SUPPORT.md

T is public alpha research software.

Research only. Not financial advice.

T does not remove market risk, data risk, model risk, operational risk, or human decision risk.

Users are responsible for reviewing outputs, validating assumptions, and complying with applicable laws and regulations.

T Technology Research Lab

━━━━━━━━━━━━━━━━━━━━ T T Technology Research Lab ━━━━━━━━━━━━━━━━━━━━