aitbc1
bfe6f94b75
Some checks failed
AITBC CI/CD Pipeline / lint-and-test (3.11) (push) Has been cancelled
AITBC CI/CD Pipeline / lint-and-test (3.12) (push) Has been cancelled
AITBC CI/CD Pipeline / lint-and-test (3.13) (push) Has been cancelled
AITBC CI/CD Pipeline / test-cli (push) Has been cancelled
AITBC CI/CD Pipeline / test-services (push) Has been cancelled
AITBC CI/CD Pipeline / test-production-services (push) Has been cancelled
AITBC CI/CD Pipeline / security-scan (push) Has been cancelled
AITBC CI/CD Pipeline / build (push) Has been cancelled
AITBC CI/CD Pipeline / deploy-staging (push) Has been cancelled
AITBC CI/CD Pipeline / deploy-production (push) Has been cancelled
AITBC CI/CD Pipeline / performance-test (push) Has been cancelled
AITBC CI/CD Pipeline / docs (push) Has been cancelled
AITBC CI/CD Pipeline / release (push) Has been cancelled
AITBC CI/CD Pipeline / notify (push) Has been cancelled
Security Scanning / Bandit Security Scan (apps/coordinator-api/src) (push) Has been cancelled
Security Scanning / Bandit Security Scan (cli/aitbc_cli) (push) Has been cancelled
Security Scanning / Bandit Security Scan (packages/py/aitbc-core/src) (push) Has been cancelled
Security Scanning / Bandit Security Scan (packages/py/aitbc-crypto/src) (push) Has been cancelled
Security Scanning / Bandit Security Scan (packages/py/aitbc-sdk/src) (push) Has been cancelled
Security Scanning / Bandit Security Scan (tests) (push) Has been cancelled
Security Scanning / CodeQL Security Analysis (javascript) (push) Has been cancelled
Security Scanning / CodeQL Security Analysis (python) (push) Has been cancelled
Security Scanning / Dependency Security Scan (push) Has been cancelled
Security Scanning / Container Security Scan (push) Has been cancelled
Security Scanning / OSSF Scorecard (push) Has been cancelled
Security Scanning / Security Summary Report (push) Has been cancelled
AITBC CLI Level 1 Commands Test / test-cli-level1 (3.11) (push) Has been cancelled
AITBC CLI Level 1 Commands Test / test-cli-level1 (3.12) (push) Has been cancelled
AITBC CLI Level 1 Commands Test / test-cli-level1 (3.13) (push) Has been cancelled
AITBC CLI Level 1 Commands Test / test-summary (push) Has been cancelled
- Remove debugging service documentation (DEBUgging_SERVICES.md) - Remove development logs policy and quick reference guides - Remove E2E test creation summary - Remove gift certificate example file - Remove GitHub pull summary documentation
2.4 KiB
2.4 KiB
Installation
Prerequisites
- Python 3.13+
- Git
- (Optional) PostgreSQL 14+ for production
- (Optional) NVIDIA GPU + CUDA for mining
Security First Setup
⚠️ IMPORTANT: AITBC has enterprise-level security hardening. After installation, immediately run:
# Run comprehensive security audit and hardening
./scripts/comprehensive-security-audit.sh
# This will fix 90+ CVEs, harden SSH, and verify smart contracts
Security Status: 🛡️ AUDITED & HARDENED
- 0 vulnerabilities in smart contracts (35 OpenZeppelin warnings only)
- 90 CVEs fixed in dependencies
- 95/100 system hardening index achieved
Monorepo Install
git clone https://github.com/oib/AITBC.git
cd aitbc
python -m venv .venv && source .venv/bin/activate
pip install -e .
This installs the enhanced AITBC CLI, coordinator API, and blockchain node from the monorepo.
Verify CLI Installation
# Check CLI version and installation
aitbc --version
aitbc --help
# Test CLI connectivity
aitbc blockchain status
Expected output:
AITBC CLI v0.1.0
Platform: Linux/MacOS
Architecture: x86_64/arm64
✓ CLI installed successfully
Environment Configuration
Coordinator API
Create apps/coordinator-api/.env:
JWT_SECRET=your-secret-key
DATABASE_URL=sqlite:///./data/coordinator.db # or postgresql://user:pass@localhost/aitbc
LOG_LEVEL=INFO
Blockchain Node
Create apps/blockchain-node/.env:
CHAIN_ID=ait-devnet
RPC_BIND_HOST=0.0.0.0
RPC_BIND_PORT=8006 # Updated to new blockchain RPC port
MEMPOOL_BACKEND=database
Systemd Services (Production)
cp systemd/aitbc-*.service /etc/systemd/system/
systemctl daemon-reload
systemctl enable --now aitbc-coordinator-api
systemctl enable --now aitbc-blockchain-node-1
Verify
systemctl status aitbc-coordinator-api
curl http://localhost:8000/v1/health
aitbc blockchain status
Troubleshooting
| Problem | Fix |
|---|---|
| Port in use | sudo lsof -i :8000 then kill the PID |
| DB corrupt | rm -f data/coordinator.db && python -m app.storage init |
| Module not found | Ensure venv is active: source .venv/bin/activate |
Next Steps
- 3_cli.md — CLI usage guide
- ../2_clients/1_quick-start.md — Client quick start
- ../3_miners/1_quick-start.md — Miner quick start