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 |
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:
- Visit the GitHub Releases page
- Download the latest
FinceptInvestmentsInstaller.exe
- Run the installer as Administrator
- Follow the installation wizard
- 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
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:
- From Main Menu: Enter the number corresponding to your desired section
- Sub-menus: Many sections have sub-menus for specific functions
- Breadcrumbs: The prompt shows your current location
- 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.
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
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"]
}
}
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"
}
}
}
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:
- Fork the repository
- Create a feature branch:
git checkout -b feature/new-feature
- Make your changes and add tests
- Run the test suite:
pytest
- Commit your changes with a descriptive message
- Push to your fork:
git push origin feature/new-feature
- 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
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.