# entalpia.xyz — Full Context

> Personal website of Stefano Fiorito — freelancer, consultant, and builder based in Loano (SV), Italy.

## About Stefano Fiorito

Stefano Fiorito is a multidisciplinary professional with over 20 years of hands-on experience at the intersection of architecture, software engineering, infrastructure, and data. He started working with computers at age 8, learned CAD at 14, and discovered the internet in 1997.

He studied architecture and developed deep expertise in 3D modeling, which led him to live in Vienna and later Lisbon. During this period he became fascinated with parametric modeling through Grasshopper (a visual programming tool for Rhino 3D), which sparked his interest in Python programming.

His academic path continued with a PhD, where he gained extensive experience with GIS systems (Geographic Information Systems), PostgreSQL/PostGIS databases, and spatial data analysis. This unique combination of architectural thinking and technical skills shaped his approach to problem-solving.

Currently based in Loano (Savona), Italy, Stefano works as a freelancer and consultant helping businesses with digital solutions — from backend APIs and infrastructure to advertising campaigns and data pipelines.

Since 2023, Stefano has been actively integrating AI into his development workflow. He uses Claude and Claude Code (Anthropic's CLI tool) as a core part of his stack for full-stack development, infrastructure automation, code review, and product building. This AI-assisted approach has accelerated his ability to ship products like annidata.it, licet.io, and the GitOps infrastructure that powers his hosting platform.

## Services — Detailed

### Online Advertisement
Active online advertiser since 2010. Primary platforms: Google ADS and Meta ADS. Additional experience with LinkedIn ADS, Twitter/X ADS, Spotify ADS, and Bing ADS.

Capabilities:
- Design and deployment of Search, Shopping, Video, and Display campaigns on Google ADS
- Full range of Meta ADS campaign types (awareness, traffic, conversions, catalog)
- Integration of monitoring tools: Google Tag Manager, Facebook Pixel, server-side tracking
- Custom reporting with Google Data Studio / Looker Studio
- Conversion-driven optimization with regular campaign tuning based on performance data
- A/B testing of creatives, landing pages, and audience segments
- Budget allocation and ROI optimization across multiple channels

### Backend Development
Python and PHP form the core backend stack, with growing expertise in TypeScript for edge computing.

Capabilities:
- Python / Flask: custom APIs, web applications, data processing pipelines
- PHP / WordPress: theme development, plugin development, WooCommerce customization, headless WordPress with WPGraphQL, mu-plugins for Custom Post Types and ACF field groups
- TypeScript / Hono: Cloudflare Workers APIs, edge computing, serverless functions
- Cloudflare Workers & Pages: edge-first architecture, R2 storage, KV, D1, Durable Objects
- Database: PostgreSQL, PostGIS, SQLite, MySQL, Redis
- API design: REST, JSON, pagination, filtering, authentication (API keys, JWT)
- Wax Blockchain: smart contract execution and design (past experience)

### AI-Assisted Development
Since 2023, AI has become a core part of the development workflow — not just for code generation, but as a collaborative tool for architecture decisions, debugging, infrastructure automation, and product design.

Capabilities:
- Claude Code (Anthropic CLI): daily driver for full-stack development, code review, refactoring, and complex multi-file changes
- Prompt engineering: crafting effective system prompts, tool definitions, and agent workflows
- AI integration in products: Claude-powered conversational chatbot in annidata.it for real estate search
- Custom agent workflows: using Claude for GitOps automation, deployment scripts, and infrastructure management
- MCP (Model Context Protocol) server integration for enhanced tool use
- Evaluating and integrating AI capabilities into client projects
- ~3 years of continuous experience building with AI assistance

### Data Scraping, Automation & Analysis
Hundreds of hours dedicated to scraping projects across diverse domains.

Capabilities:
- Single-site to web-wide scraping: from national listing portals to e-commerce platforms
- One-shot extraction and continuous monitoring pipelines
- Raw data collection and refined data transformation
- Custom scraping APIs: clients can scrape and monitor sites or apps through a dedicated API
- Desktop automation: both for scraping purposes and application testing (Selenium, Playwright)
- Data cleaning, normalization, and enrichment
- Backup and archiving of legacy websites
- Python-based: BeautifulSoup, Scrapy, requests, httpx, Playwright

### DevOps, GitOps & Hosting
Design and deployment of VPS infrastructure with a strong emphasis on GitOps — git as the single source of truth for infrastructure state.

Capabilities:
- GitOps workflow: git push triggers automated deployment, rollback on failure, declarative site configuration in YAML
- Custom GitOps agent: Python-based agent running on VPS that watches a git repo, detects changes, and applies them (container creation, SSL, DNS, backups)
- Docker orchestration: container lifecycle management, health checks, auto-restart, resource limits
- VPS provisioning: Hetzner, DigitalOcean, OVH — selecting resources based on client needs and budget
- High availability: multi-zone architecture, automatic failover considerations
- Backup strategy: automated daily backups, S3 sync (Backblaze B2), point-in-time recovery
- Monitoring: container health checks, disk usage alerts, HTTP availability monitoring
- Infrastructure as Code: all site definitions, server configs, and deploy logic stored in git
- Nginx reverse proxy, Let's Encrypt SSL, Cloudflare DNS integration
- Scalable architecture: easy horizontal scaling by adding VPS nodes

### Data Visualization
Transforming raw data into actionable insights through visual reporting.

Capabilities:
- Google Data Studio / Looker Studio: recurring reports for ad campaigns, web analytics, business metrics
- Custom dashboards: built with web technologies, fed from external APIs
- Data sources: Facebook ADS API, Google ADS API, WooCommerce REST API, custom databases
- Interactive analytics: filtering, drill-down, date range selection
- Client-facing reports: designed for non-technical stakeholders
- Real-time and batch reporting pipelines

### Architecture & 3D Modeling
Architecture degree with specialization in computational and parametric design.

Capabilities:
- Parametric modeling: Grasshopper visual programming for Rhino 3D
- Computational design: algorithmic form generation, optimization-driven geometry
- GIS: Geographic Information Systems, spatial analysis, PostGIS queries, OpenStreetMap data
- 3D rendering and visualization: photorealistic and diagrammatic
- PhD research: intersection of spatial data, urban analysis, and computational methods
- CAD: AutoCAD, Rhino, SketchUp (20+ years experience starting from age 14)

### Blockchain & Web3 Development
Experience building DApp interfaces, automated trading systems, and mining analytics across multiple blockchains.

#### WAX Blockchain — DApp Interfaces
Built web applications that interact with the WAX blockchain through its RPC API and the AtomicAssets API.

Capabilities:
- WAX RPC API interaction (via wax.greymass.com): wallet balance queries, token transfers (WAX, TLM)
- AtomicAssets API: NFT browsing, batch transfers, market pricing (/atomicassets/v1/assets, /atomicmarket/v1/sales/templates)
- WaxJS SDK + WAX Cloud Wallet for secure login and transaction signing
- IPFS integration for NFT media storage
- Smart contract development with CDT (Contract Development Toolkit) and Leap node software
- Deployed on Cloudflare Workers

#### Hyperliquid DEX — Automated Market Making Bot
Production-grade market making bot for the Hyperliquid decentralized exchange.

Capabilities:
- Hyperliquid Python SDK: Info class (L2 order book, positions, fills), Exchange class (order placement/cancellation)
- WebSocket real-time data streaming (wss://api.hyperliquid.xyz/ws)
- Multi-asset trading: BTC, ETH, SOL and 15+ assets simultaneously
- Multiple strategies: professional market maker (0.1s scans), robust mode (2s intervals), simple scalper
- Adaptive spreads: dynamically adjusted based on volatility, latency, and inventory levels
- Risk management: circuit breakers, position limits, daily loss caps (2%), drawdown monitoring
- Real-time monitoring: CLI dashboard, PnL tracking, Sharpe ratio, win rate
- Alert system: Telegram, email (SMTP), Slack webhooks
- Docker containerized with multiple compose configs (prod, robust, scalper)
- Latency-optimized: compensates for network delays, targets sub-500ms execution

#### NiceBot — Mining Profitability Analyzer
Comprehensive mining profitability analysis platform tracking 67+ algorithms and 21+ blockchains.

Capabilities:
- NiceHash API integration: order book, pricing, volume data every 5 minutes (288 snapshots/day)
- Blockchains tracked: Bitcoin (SHA256), Litecoin (SCRYPT), Monero (RandomX), Ethereum Classic (ETCHASH), Kaspa (kHeavyHash), Ravencoin (KAWPOW), Ergo (Autolykos), Zcash (Equihash), Iron Fish, Karlsen, Pyrin, Alephium, Nexa, Conflux, Beam, and more
- Blockchain statistics: network difficulty, hashrate, block rewards, mempool size from explorer APIs
- Price aggregation: Binance, CoinGecko, Coinbase feeds
- Profitability calculations: ROI, profit thresholds with fee accounting (NiceHash 2% + pool 1-2%), competitiveness scores (0-100), risk levels
- Market analysis: min/max/average/median prices, volatility, moving averages, support/resistance levels
- REST API: /api/algorithms, /api/metrics/{algo}, /api/profitability/{algo}, /api/blockchain-stats
- 90-day rolling data retention for backtesting and trend analysis

Tech stack: Cloudflare Workers, D1 (SQLite), NiceHash API, Binance/CoinGecko/Coinbase APIs, multiple blockchain explorer APIs

## Products — Detailed

### annidata.it
Backend-as-a-service for real estate data. Born from the experience of managing dozens of websites for real estate agencies, each with a different property management software and feed format.

What it does:
- Imports property feeds from any management software (XML, JSON, API)
- Normalizes N heterogeneous feeds into a single consistent API schema
- Optimizes images: downloads from feed, deduplicates via SHA-256 hash, serves on Cloudflare R2 CDN with on-demand resize (WebP, AVIF, any dimension)
- Exposes a standard REST API with JSON responses, full-text search, combinable filters, pagination
- Geospatial rating: PostGIS + OpenStreetMap for property location scoring
- AI chatbot: Claude-powered conversational search for property listings
- Multi-vendor: isolated data per agency with vendor API keys

Tech stack:
- Cloudflare Workers (API layer, image processing)
- Cloudflare R2 (image storage)
- PostgreSQL + PostGIS (geospatial data, property storage)
- Claude API (AI chatbot)
- WordPress plugin (shortcodes, Gutenberg blocks) — in development
- TypeScript SDK — in development

Performance:
- API latency under 50ms on global edge
- Sync configurable per vendor (default 2x/day), incremental
- Image CDN with on-demand transformation

### licet.io
Lightweight, privacy-first cookie consent solution built for developers and agencies.

What it does:
- GDPR and ePrivacy Directive compliant cookie consent banner
- Loads in milliseconds — minimal JavaScript footprint
- Per-purpose consent: analytics, marketing, functional — with toggles
- Respects user choices: blocks scripts until consent is granted
- One-line installation: single script tag in the head
- Customizable appearance: colors, position, text
- Multi-site management: dashboard for managing consent across multiple domains

Tech stack:
- Cloudflare Workers (consent API, script delivery)
- Edge delivery: banner script served from global CDN
- No third-party dependencies

### ceonda.it
Real-time marine and wave monitoring platform for the Ligurian coast of Italy. The name means "C'e onda?" ("Are there waves?") — built for surfers, sailors, and coastal enthusiasts.

What it does:
- Real-time data from ARPAL research buoy at Capo Mele (Liguria)
- Wave metrics: significant wave height, maximum wave, mean wave, direction, period
- Ocean temperature (sea surface temperature)
- Wind speed and direction (multiple sensors: Gill and Young anemometers)
- Current velocity and direction at 14 depths (3.5m to 70m)
- Swell calendar: month view with color-coded wave heights
- Webcam section: live beach/conditions footage
- Newsletter subscription with reCAPTCHA and AWS SES
- Data archived daily in JSON, 24-hour rolling window displayed

Tech stack:
- PHP + HTML frontend with Tailwind CSS and Chart.js
- ARPAL API (wes.arpal.liguria.it) for buoy data every 30 minutes
- MySQL database for data storage
- AWS SES for email delivery
- Google Tag Manager for analytics
- Social community: Facebook, Instagram, YouTube, Telegram (@ceonda)

### cort.ooo (in development)
URL shortener and link analytics platform.

What it does:
- Short URL creation with custom slugs
- Click analytics: geographic distribution, referrers, devices, time series
- Link management dashboard
- API for programmatic URL creation
- QR code generation

Tech stack:
- Cloudflare Workers (redirect engine, API)
- Cloudflare KV / D1 (link storage, analytics)
- SvelteKit frontend (dashboard)

## Tech Stack Summary

Languages: Python, TypeScript, PHP, SQL, JavaScript
Frameworks: Flask, Hono, SvelteKit, WordPress
Infrastructure: Cloudflare Workers/Pages/R2/KV/D1, Docker, Nginx, PostgreSQL/PostGIS
DevOps: Custom GitOps agent, S3 backups, container orchestration
AI: Claude API, Claude Code, MCP servers
Blockchain: WAX RPC API, AtomicAssets API, WaxJS SDK, Hyperliquid Python SDK, NiceHash API
Frontend: Tailwind CSS, vanilla JS, Svelte, Chart.js
Databases: PostgreSQL, PostGIS, SQLite, MySQL, Redis, Cloudflare D1/KV
Cloud: Cloudflare, Hetzner, DigitalOcean, Backblaze B2, AWS SES

## Contact

- Email: hello@entalpia.xyz
- GitHub: github.com/entalpia
- LinkedIn: linkedin.com/in/stefanofiorito
- Twitter/X: @entalpiadesign
- WhatsApp: +39 379 313 6581
- Facebook: facebook.com/entalpia

## Legal

Entalpia — Stefano Fiorito
P.IVA: 01558540090
Loano (SV), Italy