Introduction Last updated: 2025-01-18

Fincept Terminal is a comprehensive, open-source financial analytics platform designed for investors, traders, analysts, and financial enthusiasts. Built with Python and featuring an intuitive command-line interface, it provides professional-grade tools for market analysis, portfolio management, and data-driven investment decisions.

What is Fincept Terminal?

Fincept Terminal is a powerful financial research platform that combines traditional financial analysis with cutting-edge AI technology. It offers:

  • Real-time Market Data: Access to global stock markets, indices, currencies, and commodities
  • Technical Analysis: Comprehensive charting tools and technical indicators
  • Fundamental Analysis: Company financials, ratios, and valuation metrics
  • AI-Powered Insights: GenAI integration for intelligent market analysis
  • Portfolio Management: Create, track, and optimize investment portfolios
  • Economic Data: Global economic indicators and macroeconomic analysis

Why Choose Fincept Terminal?

Unlike expensive commercial platforms, Fincept Terminal is completely free and open-source, giving you professional-grade financial analysis tools without the hefty price tag.

Key Features

Global Market Coverage
  • Real-time stock prices from major exchanges
  • Global indices (S&P 500, NASDAQ, FTSE, etc.)
  • Currency exchange rates
  • Commodity prices
  • Cryptocurrency data
Technical Analysis
  • 50+ technical indicators
  • Interactive charts
  • Pattern recognition
  • Support/resistance levels
  • Bollinger Bands, RSI, MACD, and more
AI Integration
  • GenAI-powered market analysis
  • Sentiment analysis from news
  • AI investment recommendations
  • Natural language queries
  • Predictive analytics
Portfolio Management
  • Create multiple portfolios
  • Performance tracking
  • Risk analysis
  • Backtesting capabilities
  • Rebalancing suggestions

System Requirements

Component Minimum Recommended
Operating System Windows 10, macOS 10.14, Ubuntu 18.04 Windows 11, macOS 12+, Ubuntu 20.04+
Python Version Python 3.8+ Python 3.10+
Memory (RAM) 4 GB 8 GB or more
Storage 2 GB free space 5 GB free space
Internet Broadband connection High-speed broadband

Installation

Fincept Terminal can be installed in multiple ways to suit different user preferences and technical requirements. Choose the method that works best for your setup.

PyPI Installation (Recommended)

The easiest way to install Fincept Terminal is through PyPI using pip:

$ pip install fincept-terminal

This will install the latest stable version along with all required dependencies.

Virtual Environment Recommended

It's recommended to install Fincept Terminal in a virtual environment to avoid conflicts with other Python packages.

Using Virtual Environment:
$ python -m venv fincept-env
$ source fincept-env/bin/activate # On Windows: fincept-env\Scripts\activate
$ pip install fincept-terminal

Windows Installer

For Windows users who prefer a traditional installer experience:

  1. Visit the GitHub Releases page
  2. Download the latest FinceptInvestmentsInstaller.exe
  3. Run the installer as Administrator
  4. Follow the installation wizard
  5. Launch from Start Menu or Desktop shortcut

Windows Defender

Windows Defender may flag the installer as potentially unwanted software. This is a false positive common with open-source software. Click "More info" and "Run anyway" to proceed.

Installation from Source

For developers or users who want the latest features:

$ git clone https://github.com/Fincept-Corporation/FinceptTerminal.git
$ cd FinceptTerminal
$ pip install -r requirements.txt
$ python main.py
Development Installation:
$ git clone https://github.com/Fincept-Corporation/FinceptTerminal.git
$ cd FinceptTerminal
$ pip install -e .
$ fincept --dev

First Launch

After installation, launch Fincept Terminal:

$ fincept

On first launch, you'll be prompted to:

  • Set up basic configuration
  • Choose a theme
  • Configure data sources (optional)
  • Set up API keys (optional)
Command Line Options:
$ fincept --help # Show help
$ fincept --version # Show version
$ fincept --config # Open config file
$ fincept --reset # Reset to defaults

Getting Started

Learn the basics of navigating and using Fincept Terminal. This section covers the interface, basic commands, and essential workflows.

Terminal Interface

Fincept Terminal features a modern, intuitive command-line interface with several key components:

Main Menu Structure:
  • Global Indices: Track major world market indices
  • World Economy Tracker: Economic indicators and data
  • Global News & Sentiment: Financial news and market sentiment
  • Global Stocks: Individual stock analysis and screening
  • Portfolio Tools: Portfolio creation and management
  • Currency Markets: Forex and currency analysis
  • Robo Advisor: AI-powered investment recommendations
  • Advanced Technicals: Sophisticated technical analysis tools
Interface Elements:
  • Command Prompt: Enter commands and navigate menus
  • Data Display: Tables, charts, and analytical outputs
  • Status Bar: Current mode, connection status, and shortcuts
  • Help System: Context-sensitive help and documentation

Basic Commands

Essential commands for navigating Fincept Terminal:

Command Description Example
help Show help for current menu help
quit or q Exit current menu or terminal q
cls or clear Clear the screen cls
home Return to main menu home
back Go back to previous menu back
search Search for stocks or symbols search AAPL
Navigation Tips:
  • Use Tab for auto-completion
  • Use arrow keys to navigate command history
  • Type menu numbers to quickly access sections
  • Use Ctrl+C to interrupt long-running operations

Navigation

Understanding how to move between different sections of Fincept Terminal:

Menu Navigation:
  1. From Main Menu: Enter the number corresponding to your desired section
  2. Sub-menus: Many sections have sub-menus for specific functions
  3. Breadcrumbs: The prompt shows your current location
  4. Quick Access: Use shortcuts for frequently accessed functions
Example Navigation Flow:
Fincept Terminal > 4. Global Stocks > 1. Stock Screener > Enter criteria

Pro Tip

Bookmark frequently used sections by creating custom shortcuts in your configuration file.

Core Features

Explore the powerful features that make Fincept Terminal a comprehensive financial analysis platform.

Global Indices

Monitor major stock market indices from around the world in real-time:

Supported Indices:
  • US Markets: S&P 500, NASDAQ, Dow Jones
  • European: FTSE 100, DAX, CAC 40
  • Asian: Nikkei 225, Hang Seng, Shanghai Composite
  • Emerging Markets: MSCI EM, BRIC indices
  • Sector Indices: Technology, Healthcare, Energy
  • Commodity Indices: Gold, Oil, Agricultural products
Available Features:
  • Real-time price updates
  • Historical performance charts
  • Correlation analysis between indices
  • Heat maps for global market overview
  • Export data to CSV/Excel

Stock Analysis

Comprehensive tools for analyzing individual stocks:

Fundamental Analysis:
  • Financial Statements: Income statement, balance sheet, cash flow
  • Key Ratios: P/E, P/B, ROE, ROA, debt-to-equity
  • Valuation Metrics: DCF models, comparable company analysis
  • Growth Analysis: Revenue growth, earnings growth, margin trends
Technical Analysis:
  • Chart Patterns: Head and shoulders, triangles, flags
  • Indicators: Moving averages, RSI, MACD, Bollinger Bands
  • Support/Resistance: Automatic level detection
  • Volume Analysis: Volume indicators and patterns
Example: Analyzing Apple (AAPL)
stocks> load AAPL
AAPL> overview
AAPL> financials
AAPL> chart --period 1y --indicators rsi,macd

Economic Data

Access comprehensive economic indicators and macroeconomic data:

Available Data Sources:
  • FRED (Federal Reserve Economic Data): US economic indicators
  • World Bank: Global development indicators
  • IMF: International monetary and financial statistics
  • OECD: Economic outlook and country statistics
Key Indicators:
  • GDP Growth Rates
  • Inflation (CPI, PPI)
  • Employment Statistics
  • Interest Rates
  • Trade Balances
  • Currency Exchange Rates
  • Consumer Confidence
  • Manufacturing PMI

News & Sentiment Analysis

Stay informed with real-time financial news and AI-powered sentiment analysis:

News Sources:
  • Reuters
  • Bloomberg
  • Financial Times
  • MarketWatch
  • Yahoo Finance
  • SEC Filings (8-K, 10-K, 10-Q)
Sentiment Analysis Features:
  • Article Sentiment: Positive, negative, neutral classification
  • Entity Recognition: Identify companies, people, and topics
  • Trend Analysis: Sentiment trends over time
  • Market Impact: Correlation with price movements

Portfolio Management

Create, manage, and optimize investment portfolios:

Portfolio Creation:
portfolio> create "My Tech Portfolio"
portfolio> add AAPL 100 shares
portfolio> add GOOGL 50 shares
portfolio> add MSFT 75 shares
Analysis Features:
  • Performance Tracking: Total return, annualized return, Sharpe ratio
  • Risk Analysis: Beta, standard deviation, Value at Risk (VaR)
  • Asset Allocation: Sector, geographic, market cap breakdown
  • Rebalancing: Automatic suggestions and execution
  • Backtesting: Historical performance simulation
Optimization Tools:
  • Modern Portfolio Theory (MPT)
  • Efficient Frontier analysis
  • Factor-based optimization
  • ESG integration

AI Features

Leverage artificial intelligence for enhanced financial analysis:

GenAI Integration:
  • Natural Language Queries: Ask questions in plain English
  • Research Assistant: AI-powered financial research
  • Investment Ideas: AI-generated investment recommendations
  • Risk Assessment: Intelligent risk analysis and warnings
Example AI Queries:
ai> "What are the best dividend stocks in the healthcare sector?"
ai> "Analyze the risk of my current portfolio"
ai> "Find undervalued tech stocks with strong fundamentals"
Machine Learning Features:
  • Stock price prediction models
  • Anomaly detection in market data
  • Pattern recognition in charts
  • Automated trade signal generation

Configuration

Customize Fincept Terminal to match your preferences and workflow requirements.

Settings File

Fincept Terminal uses a JSON configuration file located at:

  • Windows: %APPDATA%\fincept\user_settings.json
  • macOS: ~/Library/Application Support/fincept/user_settings.json
  • Linux: ~/.config/fincept/user_settings.json
Configuration Structure:
{
  "general": {
    "theme": "dark",
    "auto_update": true,
    "default_currency": "USD",
    "timezone": "America/New_York"
  },
  "data_sources": {
    "primary": "yahoo",
    "backup": "financial_modeling_prep",
    "news": "newsapi"
  },
  "api_keys": {
    "financial_modeling_prep": "your_api_key_here",
    "newsapi": "your_newsapi_key_here",
    "openai": "your_openai_key_here"
  },
  "display": {
    "max_rows": 50,
    "decimal_places": 2,
    "use_colors": true
  },
  "portfolio": {
    "default_portfolio": "main",
    "auto_save": true,
    "backup_frequency": "daily"
  }
}

API Keys

Many features require API keys from data providers. Here's how to set them up:

Required API Keys:
Provider Features Free Tier Setup
Financial Modeling Prep Company financials, real-time data 250 requests/day Get API Key
News API Financial news aggregation 1000 requests/month Get API Key
OpenAI AI-powered analysis and chat $5 credit Get API Key
FRED API Economic data from Federal Reserve Unlimited (free) Get API Key
Setting API Keys:
$ fincept --config
# Edit the api_keys section in the opened file
# Or use the built-in configuration menu:
fincept> settings
settings> api_keys

Themes

Customize the appearance of Fincept Terminal with various themes:

Available Themes:
  • Dark (Default): Dark background, green accents
  • Light: Light background, blue accents
  • Solar Flare: Orange and yellow color scheme
  • Ocean Breeze: Blue and teal colors
  • Forest: Green and brown natural colors
  • Neon: Bright cyberpunk-inspired colors
  • Minimal: Monochrome with minimal colors
Changing Themes:
fincept> settings
settings> theme
theme> select ocean_breeze
Custom Theme Creation:

Create your own theme by modifying the theme configuration:

{
  "custom_theme": {
    "name": "My Custom Theme",
    "colors": {
      "primary": "#00ff88",
      "secondary": "#ff8800",
      "background": "#1a1a1a",
      "text": "#ffffff",
      "accent": "#ffff00"
    }
  }
}

Data Sources

Configure multiple data sources for redundancy and comprehensive coverage:

Supported Data Providers:
  • Yahoo Finance: Free, reliable for basic data
  • Financial Modeling Prep: Comprehensive financial data
  • Alpha Vantage: Real-time and historical data
  • IEX Cloud: High-quality market data
  • Quandl: Alternative and economic data
Data Source Priority:
{
  "data_sources": {
    "stock_data": ["financial_modeling_prep", "yahoo", "alpha_vantage"],
    "news": ["newsapi", "rss_feeds"],
    "economic": ["fred", "world_bank"],
    "crypto": ["coinbase", "binance"]
  }
}

Advanced Usage

Learn advanced features and techniques for power users and developers.

Scripting and Automation

Automate repetitive tasks and create custom workflows:

Fincept Scripts:

Create custom scripts using Fincept's built-in scripting language:

# daily_analysis.fincept
portfolio load "main"
portfolio performance --period 1d
stocks load AAPL GOOGL MSFT
stocks overview
news sentiment --symbols AAPL,GOOGL,MSFT
export results daily_report.xlsx
Running Scripts:
$ fincept --script daily_analysis.fincept
$ fincept --batch scripts/weekly_analysis/
Python Integration:

Use Fincept Terminal as a Python library:

from fincept import Terminal

# Initialize terminal
ft = Terminal()

# Load stock data
aapl = ft.stocks.load("AAPL")
print(aapl.overview())

# Create portfolio
portfolio = ft.portfolio.create("Tech Stocks")
portfolio.add("AAPL", shares=100)
portfolio.add("GOOGL", shares=50)

# Get performance metrics
performance = portfolio.performance()
print(f"Total Return: {performance.total_return:.2%}")

Custom Indicators

Create and implement custom technical indicators:

Indicator Development:
from fincept.indicators import BaseIndicator
import pandas as pd

class CustomRSI(BaseIndicator):
    """Custom RSI with additional smoothing"""
    
    def __init__(self, period=14, smoothing=3):
        self.period = period
        self.smoothing = smoothing
    
    def calculate(self, data):
        """Calculate custom RSI"""
        delta = data.diff()
        gain = (delta.where(delta > 0, 0)).rolling(window=self.period).mean()
        loss = (-delta.where(delta < 0, 0)).rolling(window=self.period).mean()
        
        rs = gain / loss
        rsi = 100 - (100 / (1 + rs))
        
        # Apply smoothing
        return rsi.rolling(window=self.smoothing).mean()

# Register the indicator
ft.indicators.register("custom_rsi", CustomRSI)
Using Custom Indicators:
AAPL> ta custom_rsi --period 21 --smoothing 5
AAPL> chart --indicators custom_rsi

Automation and Alerts

Set up automated monitoring and alert systems:

Price Alerts:
alerts> create price AAPL above 150
alerts> create price GOOGL below 2500
alerts> create volume TSLA above_average 200%
Technical Alerts:
alerts> create technical AAPL rsi oversold
alerts> create technical SPY macd_bullish_crossover
News Alerts:
alerts> create news AAPL sentiment negative
alerts> create news earnings_announcement GOOGL
Automated Reports:
{
  "scheduled_reports": {
    "daily_portfolio": {
      "schedule": "0 9 * * 1-5",
      "script": "daily_portfolio_report.fincept",
      "email": "investor@example.com"
    },
    "weekly_market_summary": {
      "schedule": "0 18 * * 5",
      "script": "weekly_summary.fincept",
      "export": "reports/weekly_summary.pdf"
    }
  }
}

Contributing

Join the Fincept Terminal open-source community and help improve the platform for everyone.

Development Setup

Set up your development environment to contribute to Fincept Terminal:

Prerequisites:
  • Python 3.8 or higher
  • Git
  • Code editor (VS Code, PyCharm recommended)
  • GitHub account
Development Installation:
$ git clone https://github.com/Fincept-Corporation/FinceptTerminal.git
$ cd FinceptTerminal
$ python -m venv venv
$ source venv/bin/activate # On Windows: venv\Scripts\activate
$ pip install -e .[dev]
$ pre-commit install
Project Structure:
FinceptTerminal/
├── fincept/                 # Main package
│   ├── __init__.py
│   ├── core/               # Core functionality
│   ├── data/              # Data providers
│   ├── analysis/          # Analysis modules
│   ├── ui/               # User interface
│   └── utils/            # Utility functions
├── tests/                 # Test suite
├── docs/                 # Documentation
├── scripts/              # Build and deployment scripts
├── requirements/         # Dependency files
└── setup.py             # Package setup
Running Tests:
$ pytest tests/
$ pytest tests/test_core.py -v
$ pytest --cov=fincept tests/

Contributing Guidelines

Follow these guidelines when contributing to the project:

Code Style:
  • Follow PEP 8 Python style guidelines
  • Use type hints for function parameters and returns
  • Write docstrings for all public functions and classes
  • Maximum line length: 88 characters (Black formatter)
Commit Messages:

Use conventional commit format:

feat: add new portfolio optimization algorithm
fix: resolve data loading issue with Yahoo Finance
docs: update installation instructions
test: add unit tests for technical indicators
Pull Request Process:
  1. Fork the repository
  2. Create a feature branch: git checkout -b feature/new-feature
  3. Make your changes and add tests
  4. Run the test suite: pytest
  5. Commit your changes with a descriptive message
  6. Push to your fork: git push origin feature/new-feature
  7. Create a pull request with detailed description

Code Review Process

All pull requests require review from at least one maintainer. Be prepared to address feedback and make necessary changes.

Issue Reporting

Help improve Fincept Terminal by reporting bugs and suggesting features:

Bug Reports:

When reporting bugs, include:

  • Steps to reproduce the issue
  • Expected vs. actual behavior
  • System information (OS, Python version)
  • Error messages and stack traces
  • Screenshots if applicable
Feature Requests:

For feature requests, provide:

  • Clear description of the desired feature
  • Use case and benefits
  • Mockups or examples if applicable
  • Willingness to contribute to implementation
Issue Templates:

Use the provided issue templates on GitHub:

  • Bug Report: For reporting software bugs
  • Feature Request: For suggesting new features
  • Documentation: For documentation improvements
  • Question: For general questions about usage

FAQ & Troubleshooting

Find answers to common questions and solutions to typical issues.

Installation Issues

Installation fails with "Permission denied" error

Solution: Run the installation with appropriate permissions:

# On Windows (run as Administrator)
$ pip install --user fincept-terminal

# On macOS/Linux
$ sudo pip install fincept-terminal
# Or better, use a virtual environment
Python version compatibility error

Solution: Ensure you're using Python 3.8 or higher:

$ python --version
$ python3 --version
# If needed, install a newer Python version
Dependencies installation fails

Solution: Update pip and try again:

$ python -m pip install --upgrade pip
$ pip install fincept-terminal --no-cache-dir
Windows Defender blocks installation

Solution: This is a false positive. Add an exception or temporarily disable real-time protection during installation.

Usage Questions

How do I get API keys for data sources?

Answer: Most data providers offer free tier API keys:

  • Financial Modeling Prep: 250 free requests/day
  • News API: 1000 free requests/month
  • FRED: Unlimited free access
  • Yahoo Finance: No API key required (built-in)
Can I use Fincept Terminal without internet?

Answer: Limited functionality is available offline using cached data, but real-time features require an internet connection.

How do I export data to Excel/CSV?

Answer: Use the export command in any data view:

stocks> export data.xlsx
portfolio> export performance.csv
Is my financial data secure?

Answer: Yes, Fincept Terminal stores all data locally on your machine. Portfolio and personal data never leaves your computer unless you explicitly export it.

Performance Tips

Terminal is running slowly

Solutions:

  • Reduce the number of displayed rows: set max_rows 25
  • Clear cache regularly: cache clear
  • Close unused data connections
  • Increase available RAM if possible
Data loading takes too long

Solutions:

  • Check your internet connection speed
  • Try different data sources in settings
  • Reduce the time period for historical data
  • Use data caching: set cache_enabled true
Memory usage is high

Solutions:

  • Limit historical data retention
  • Clear unused portfolios and watchlists
  • Restart the terminal periodically
  • Disable unused features in settings

Performance Optimization

For best performance, run Fincept Terminal on a system with at least 8GB RAM and an SSD. Close other resource-intensive applications when performing complex analysis.